session-reflection-analysis

Session Reflection Analysis 技能专为使用 Claude Code 进行高效开发的工程师所设计。通过编程方式处理会话历史，此工具能协助您识别浪费资源的重复模式，例如重复读取文件、错误的路经探索，或可自动化的手动步骤。它是一个元分析 (meta-analysis) 工具，通过改进文档、自定义斜线命令及优化工作习惯，协助您长期提升 AI 的效能。

• 自动根据当前目录定位存储在 ~/.claude/projects/ 中的特定项目会话文件。

• 使用 jq 生成高度压缩的 JSONL 摘要，在保留用户意图、工具调用与结果大小等重要上下文的同时，将 Token 消耗降至最低。

• 部署一个「Explore」子代理程序对摘要文件进行启发式分析，寻找 Token 浪费、重复错误或缺失自动化等效率低下指标。

• 生成结构化的 Markdown 反思文档，提供可直接复制使用的项目改进方案。

• 依优先级对调查结果进行分类，并引用您的实际聊天记录作为具体范例以佐证每项建议。

• 请务必使用提供的 jq 脚本来产生摘要；切勿直接读取原始会话文件，以免超过 Token 限制。

• 产出内容仅供建议；请仔细审阅建议的改进措施，并手动套用至您的 CLAUDE.md、.claude/skills 或 .claude/commands/ 目录中。

• 针对常见效率问题：识别您是否重复读取文件、未能验证假设，或错失了更新文档的机会。

• 此工具最适合在长工作阶段结束时使用，或当您感觉代理程序效能下降时使用。它并非用于实时代码生成，而是为了在开发生命周期中实现持续的流程改进。