用途:对当前分支相对基线分支(默认自动检测 develop/main/master)的实际开发过程做复盘,关注“花了多少时间、走了哪些弯路”,而非交付了什么,并把教训沉淀为后续会话可用的规则。
主要能力:收集 git 信号(提交、revert/fixup 等关键词、reflog 中的 reset/amend/force、文件改动频次);通过 devsql 查询分支时间窗内的提示历史,筛选 rollback/revert/undo/not working 等挫败模式;解析 ~/.claude/projects/<slug>/*.jsonl 会话记录中的工具调用失败与测试失败;统计耗时、会话数;识别跨提交与跨会话的返工;按 Instructions、Tools、Environment、State、Feedback 五个子系统归类信号并生成报告。
使用方式:在非基线分支上运行,先确认 pwd 与 git rev-parse --abbrev-ref HEAD,并检查 which devsql。可选参数 $0 指定基线分支。随后按步骤采集信号、生成报告,再通过 AskUserQuestion 与用户确认保留哪些经验,最后追加写入仓库根目录的 CLAUDE.local.md(确保其被 gitignore)。
适用场景:分支开发结束后的过程复盘、识别反复返工与工具/环境/指令层面的系统性瓶颈、把教训固化为本地规则。
限制:仅做只读分析,不执行破坏性 git 命令,不提交或推送;唯一写入的是被忽略的 CLAUDE.local.md,必要时修改 .gitignore。缺少 devsql 时跳过对应信号,会话日志解析失败时跳过相应步骤,仍基于可用信号出报告。信号超过 50 行时只汇总并展示最近 10 条。典型节奏为每分支每天一次复盘。