session-reflection-analysis

session-reflection-analysis 技能是为使用 Claude Code 的开发人员设计的自我剖析工具。通过处理存储在 ~/.claude/projects/ 中的本地 JSONL 会话日志，此技能可识别重复出现的效率低下模式，例如冗余的文件读取、错误的工具排序或上下文丢失。它专为希望在保持高开发速度的同时，将 Token 使用量控制在预算内的工程师而设计。此技能不再需要手动解析日志，而是利用 jq 生成用户请求、工具执行和系统响应的精简摘要，然后由专门的子代理程序进行分析，提供可操作的结构化反馈。

• 自动将当前工作目录映射至相关的 Claude Code 项目日志。

• 使用高效的 jq 过滤器将会话历史压缩达 98%，在保留关键上下文的同时剔除无用信息。

• 启动 Explore 子代理程序以检测诸如浪费 Token、重复错误、缺少自动化以及基于假设的错误等模式。

• 产生包含优先级改进建议、代码片段和预期影响指标的结构化 Markdown 反思文档。

• 通过建议改进措施而非直接执行，提供安全的人工审核过程。

• 若要触发此技能，请询问会话执行情况。

• 确保系统已安装 jq (brew install jq 或 apt install jq)。

• 此技能需要访问 ~/.claude/projects/，并将分析输出至 /tmp/session-summary.jsonl。

• 使用产生的建议来更新 CLAUDE.md、在 .claude/skills/ 中创建自定义 bash 脚本，或定义新的斜线指令以防止未来发生效率低下问题。

• 在执行之前务必审核建议的变更，以确保它们符合项目的具体编码标准和架构需求。

• 输出包含每项建议的详细成本效益分析，有助于优先处理高影响力的文档更新或自动化任务。