// 按 YYYY-MM-DD 在 Windows/macOS/Linux 检索本机聊天与 Agent 会话历史（Claude Code 项目 jsonl、Codex CLI history.jsonl、Cursor workspaceStorage 与 state.vscdb）；可只导出用户提示词。用户要查看或导出某日记录、按天筛 jsonl/SQLite、只抽提示词、排查历史丢失或做只读审计时使用。
SummerSec personal Agent Skills collection — writing-zh, media-tools, dev-tools, agents-dev.
管理 submodule skill 与插件同步：添加/删除映射、运行同步脚本。sync skills、sync plugins、skill-map.json、--add-plugin、从 submodule 导入
用于优化、审查或诊断 Agent Skills（SKILL.md）：优化 skill、skill 质量、重构技能、/optimize-skill、/skill-audit、optimize skills、analyze skills、check my skills、skills 不触发、skill 没生效。
当用户要求创建流程编排类 Skill、管线 Skill、工作流 Skill、多步骤分析 Skill，或提及流程编排、pipeline skill、workflow skill、步骤框架、进度文件、任务编排、审计流程、分析管线、复杂任务 skill时，应使用此技能。提取自 biz-vul-security 的六大架构模式（进度文件驱动、步骤框架分离、三阶段执行、脚本自动化、资源分层、路径一致性），提供从需求梳理到交付自检的完整方法论。
用于维护 SumSec-Skills 多平台插件元数据与发布清单：package.json、plugin.json、Claude/Cursor/Codex manifest、marketplace JSON、版本号、描述、关键词、安装文档。
SummerSec personal Agent Skills collection. Contains reusable SKILL.md files organized by category. Use when you need to leverage skills from writing-zh, media-tools, dev-tools, or agents-dev plugins.
| name | agent-chat-history |
| description | 按 YYYY-MM-DD 在 Windows/macOS/Linux 检索本机聊天与 Agent 会话历史（Claude Code 项目 jsonl、Codex CLI history.jsonl、Cursor workspaceStorage 与 state.vscdb）；可只导出用户提示词。用户要查看或导出某日记录、按天筛 jsonl/SQLite、只抽提示词、排查历史丢失或做只读审计时使用。 |
| disable-model-invocation | true |
YYYY-MM-DD：用 ${CLAUDE_SKILL_DIR} 定位脚本并运行下方命令；若当前环境不支持该变量，再进入 skill 根目录 agent-chat-history/ 执行；需要给下游贴结果时优先 --json。YYYY-MM-DD（本地时区日界），再问是否只要提示词、是否限定某一客户端。--prompts-only（可加 --include-claude-global-history）；只要路径/文件线索 → 默认列表模式，必要时加 --sqlite-keys。--claude-scan all；仍不对则读 references/storage-paths.md 核对自定义安装路径。不要先把本文件整篇读进上下文。 优先直接执行脚本：
python "${CLAUDE_SKILL_DIR}/scripts/query_history.py" --date YYYY-MM-DD
python "${CLAUDE_SKILL_DIR}/scripts/query_history.py" --date YYYY-MM-DD --prompts-only --json
常用参数（完整表与 JSON 形状见 references/query-history-script.md）：
| 参数 | 含义 |
|---|---|
--date | 必填，本地日历日 YYYY-MM-DD |
--prompts-only | 只提取用户侧提示词（Cursor 为启发式，可能不全） |
--json | 结构化输出，便于原样贴回或只摘 prompts 数组 |
--mode | all（默认）或 claude / codex / cursor 只查一类 |
路径规则与手工命令见 references/storage-paths.md、references/query-examples.md。
state.vscdb 已知 key 启发式抽取，版本变更后可能漏项或混入非纯用户句。history.jsonl 行内 ts（Unix 秒）；无 ts 的行不会进入结果。CODEX_HOME、CLAUDE_CONFIG_DIR、Cursor --user-data-dir、Flatpak/Snap）：脚本只覆盖常见布局，须对照 storage-paths.md 自行定位后再查。| 客户端 | 要点 |
|---|---|
| Claude Code | ~/.claude/projects/**/*.jsonl + 可选 history.jsonl；列表模式用 mtime 落在本地日 |
| Codex | history.jsonl 行内 ts（Unix 秒）落在本地日 |
| Cursor | workspaceStorage/<hash>/ 目录 mtime + state.vscdb；--sqlite-keys 仅列表模式下列 key |
路径与 DB key 随版本变化；未开启持久化或清理缓存可能导致无命中。只读；勿删改他人数据。