Systematic Debugging Skill

Systematic Debugging 是 Superpowers 中的一个 Skill（Skill 源码）。遇到任何 bug、测试失败或异常行为时，在智能体提出修复之前它就会激活，用四阶段的根因排查流程取代"改改试试"。

它的铁律是："没有先做根因调查，就不做修复。"

核心功能

• 第一阶段，根因调查：完整阅读报错和堆栈，稳定复现，检查最近的改动；多组件系统要在每个边界记录输入输出，找到断在哪一层。
• 第二阶段，模式分析：找到相似的可用代码，完整阅读参考实现，列出所有差异。
• 第三阶段，假设验证：提出单一假设（"X 是原因，因为 Y"），用最小改动验证，一次只改一个变量。
• 第四阶段，实施修复：先写失败的测试（借助 TDD Skill），只做一处修复，再验证。
• 三次规则：连续三次修复失败后停下，与你一起质疑架构，而不是尝试第四次。
• 配套技巧：根因回溯、纵深防御、基于条件的等待（附 TypeScript 示例），以及用于定位相互污染测试的 find-polluter.sh。

适用场景

• 不稳定或失败的测试、构建失败、集成问题。
• 时间紧迫的线上 bug，Skill 特别指出这时最容易靠猜。
• 上一次修复没有奏效的任何时候。

定价

免费开源，MIT 许可证。Superpowers 背后的公司 Prime Radiant 为企业提供商业支持。实际成本主要是 token：流程类 Skill 会增加提问、评审和子智能体运行。

快速开始

Superpowers 以一个插件整体安装，这个 Skill 会连同整套库一起装上（v6.4.1 共 15 个 Skill）。在 Claude Code 中运行 /plugin install superpowers@claude-plugins-official。Cursor 用 /add-plugin superpowers，Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers，Codex、GitHub Copilot CLI、OpenCode、Pi 等工具的命令见 README。Skill 会自动触发，也可以直接点名调用。 之后报告一个 bug，智能体应先复现并收集证据，而不是直接改代码。

局限：对真正琐碎的 bug 流程偏慢；在每一层加诊断日志会带来临时噪音，事后需要清理。

常见问题

智能体最后还会修 bug 吗？

会，在第四阶段、能够解释原因之后。

怎么防止它无限循环？

三次修复失败规则会把决定权交还给你。

替代方案

• Andon：把智能体的每个缺陷变成长期对策。
• Unlazy：用可运行的验收关卡约束大块工作。
• Verification Before Completion：用新鲜证据确认修复。

总结

它让智能体像严谨的工程师一样调试，而不是像拉老虎机。更多见 skills 分类。