Codex 的 Superpowers systematic debugging skill
Superpowers 里的 systematic debugging skill 不让 Codex 靠猜来修 bug。改代码之前,它必须先排查、找到根本原因,并写一个会失败的测试。它包含在 Jesse Vincent 开发的 Superpowers 插件里。
更新于 2026年11月12日 · 阅读约 3 分钟
速览
| Skill 名称 | systematic-debugging |
| 来自 | Jesse Vincent 开发的 Superpowers 插件 |
| 安装 | codex plugin add superpowers@openai-curated,或在 Codex 里运行 /plugins |
| Codex 何时使用 | 遇到 bug、测试失败或意料之外的行为时,在提出修复方案之前 |
| 源码 | GitHub 上的 openai/plugins |
它能做什么
这个 skill 的核心规则是「没有先排查根本原因,就不许修」。Codex 按四个阶段推进,每个阶段做完才进入下一个:
- 根本原因: 完整读完报错和调用栈,复现 bug,查看最近的改动;在由多个部分组成的系统里,记录每一层的输入和输出,看问题出在哪一层。
- 模式: 找到能正常工作的类似代码,完整读完参考实现,列出所有差异。
- 假设: 提出一个原因并说明理由,用尽可能小的改动去验证;如果不成立,就提出新的假设,而不是把修复一层层叠上去。
- 实现: 写一个会失败的测试,在源头做一处修复,再确认没有弄坏别的东西。
如果连续三次修复都失败,skill 会让 Codex 停下来,先和你一起质疑架构,再考虑第四次尝试。它还列出了一些意味着在走捷径的念头,比如「改一下 X 试试看」。
文件夹里还有几份辅助指南:沿着调用栈回溯 bug、在多个层级加校验、用条件轮询代替固定的超时等待;另外附带一个 find-polluter.sh 脚本,用二分法找出是哪个测试留下了多余的文件。
什么时候用
如果 Codex 经常只治标、修复越堆越多,或者在一个 bug 上来回打转,就装上它。它对不稳定的测试、构建失败,以及跨多个组件的 bug 最有用。
试一试
正确地排查一个失败的测试
使用 systematic debugging skill。昨天合并之后,结账测试在 CI 上开始失败,但在本地能通过。在改任何东西之前,先找到根本原因。
Claude Code 里能用吗?
能。Superpowers 的 README 把 Claude Code 列为支持的 Agent,可以从 Claude 官方插件市场安装。请用那个插件,不要只复制这个文件夹,因为这个 skill 会指向其他负责测试驱动开发和验证的 Superpowers skill。