用途
debug-retro 是一个调试会话复盘技能,通过 /debug-retro 命令触发。它的核心假设是:在一次调试会话中,人类每次介入,都提供了智能体本可以自己找到的东西。该技能统计这些介入次数,并为每一次介入安排一个“长期归宿”,使下一次调试需要的人类介入更少。其目标是每个 bug 零次介入。
主要能力
1. 列出介入
从调试会话开始处读取对话。介入被定义为满足以下某一类的人类消息:
- control:人类给出了对比案例,或要求智能体建立一个对比案例。
- fact:人类提供了数据,或指向了智能体尚未收集的数据。
- constraint:人类用一个事实反驳,从而否定了某个假设。
- proxy:人类运行了命令、粘贴了输出或截图,或引用了智能体本可以自己读取的仪表盘数字。
- method:人类告诉智能体如何工作,例如运行复现、引用、拆分假设、深入一层。
- decision:人类选择了修复方案,或做出了回滚、升级、范围方面的决定。
原始 bug 报告不算介入。decision 属于预期行为,因此单独计数,不计入其余类别。
完成标准:会话中的每条人类消息都被列出并标注类别,或作为原始报告被跳过。
2. 为每次介入安排归宿
对每次介入,提出最小的长期改动,使智能体本可以独自完成它:
- control、fact、proxy:在项目根目录的 .claude/debug-layers.md 中加一行。若文件不存在则创建,标题为 # Debug layers: learned in this codebase。写明来源、确切的查询或命令,以及它显示的信号。如果没有工具能访问该数据,则把缺失的访问方式(如 MCP 服务器、只读凭证)列为给用户的后续事项。
- constraint:把本应默认收集的事实按上述方式写入。如果缺失的部分是代码中的设计规则(例如“这个状态机是一次性的”),则在仓库中列出一个能强制该规则的测试作为后续事项。
- method:先检查 debugging-by-constraints 的 SKILL.md。如果该技能缺少这条规则,则提出该规则。如果技能已有该规则而智能体跳过了它,说明措辞太弱:为该行提出更明确的措辞。归宿是向 https://github.com/rajnandan1/sharper-skills 提交 issue 或 pull request,并附上确切的行,因为已安装的技能文件属于插件,更新会覆盖它们。
- decision:仅当该决定会再次出现时,才在项目的 CLAUDE.md 或反馈记忆中写一条策略行(例如“当 p99 连续 15 分钟翻倍时,回滚一个慢但正确的功能”)。一次性的决定就保持一次性。
- 需要深入一层才能找到的信号:为代码库列出一个后续事项,指明默认应输出的日志行或指标,以便下一次会话在第 1 层就能找到它。
3. 先展示,再写入
打印:
- Interventions this session: N (plus D decisions).
- 一张表格:编号、类别、人类说了什么(引用)、建议的归宿、要添加的确切文本。
- 需要用户或仓库处理的后续事项。
请用户按编号批准各行。只写入已批准的行。在添加一行之前,检查目标文件是否已经说了同样的事;如果已有,则更新现有行,而不是添加第二行。
完成标准:每次介入都被写入、被用户拒绝,或被列为后续事项。
使用方式
在调试会话结束后调用 /debug-retro。技能会读取本次会话,列出介入、分类、提出归宿,展示表格并等待用户按编号批准,然后写入已批准的内容。
适用场景
- 调试会话结束后进行复盘,减少未来同类调试中的人类介入。
- 把调试中反复出现的人类提示沉淀为项目级规则、技能规则或代码库改进。
- 团队希望逐步降低每个 bug 所需的人类介入次数。
限制
- 该技能依赖对调试会话对话的读取,需要会话上下文可用。
- 写入操作需要用户按编号批准,不会自动写入。
- method 类介入的归宿是向外部仓库提交 issue 或 PR,因为已安装的技能文件会被插件更新覆盖。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。