Superpowers 系统性调试
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/nic-yuan-superpowers-systematic-debugging-yuan-102。
技能介绍
问题:猜修复比 bug 本身更贵
测试红灯、生产告警或构建失败时,最常见的失误是:还没读懂错误就改代码、一次堆多个变更,或用「快速补丁」把症状盖住。SKILL.md 把这类做法定性为在浪费时间的同时制造新 bug;核心原则是永远先找根本原因,再尝试修复。
技能如何约束调试过程
技能把调试收成四个阶段,并规定:没完成阶段 1(根本原因调查),就不能提出修复方案。
- 阶段 1:细读错误与堆栈、稳定复现、查
git diff/ 最近依赖与环境变更;若错误在调用栈深处,沿数据流追到坏值源头,不在症状处打补丁。 - 阶段 2:在同仓库找能正常工作的类似实现,逐行对照参考模式,列出与工作实例的全部差异(不默认「这个小差别没关系」)。
- 阶段 3:写出可检验的假设(「我认为 X 是根因,因为 Y」),用最小变更、一次只动一个变量做验证;不懂就说不懂,不假装。
- 阶段 4:先写(可自动化的)失败用例(可与 superpowers-tdd 配合),再单一修复根因;验证通过与否,并统计已尝试修复次数——≥3 次仍失败则停止继续堆修复,转而在与主人讨论后质疑架构是否合理。
流程表里对每阶段的成功标准写得很清楚:理解「什么和为什么」、识别差异、确认或推翻假设、测试通过且问题真的消失。
适用边界与注意点
技能明确适用于测试失败、生产 bug、意外行为、性能、构建与集成问题;尤其在时间紧、「就一个快速修复」、已试过多轮、上次修复无效或尚未完全理解时——这些正是最容易瞎猜的场景。
若调查发现问题确属环境、时序或外部依赖,应记录已调查内容并实现重试、超时或更好错误信息,而非硬编「根因」;但文档也指出,多数「没有根本原因」其实是调查不完整。
出现「先快速修以后再查」「跳过测试手动验」「再试一次修复(已 ≥2 次)」等红旗,或主人说「别猜了」「再想清楚」时,应回到阶段 1,而不是在顶上加更多修补。
使用场景
- CI 某条用例稳定失败,需先复现步骤并对照最近提交与依赖变更,再允许提修复
- 生产堆栈指向深层调用,需沿入参数据流追到首次产生异常值的代码位置
- 同一问题已改两处仍冒出别处新报错,需中止叠加修补并回到错误阅读与复现阶段
- 本地或流水线构建失败,需完整消化错误码与警告信息后再形成单变量验证假设
适合人员
- 承担 on-call 的生产故障值班工程师,希望助手不要未复现就提交「试试看」式改动
- 在单体/遗留仓库里维护 flaky 测试的开发者,需要对照同库正常实现逐差异排查
- 审代码时强调证据链的 Tech Lead,要求 AI 与用户一样遵守四阶段铁律
- 联调集成阶段反复踩环境差异的工程师,需要先记录调查再谈超时或重试类处理