跳到正文
Codex DesignBETA

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。

继续阅读

Codex Design 是独立开发的 Codex 插件,与 OpenAI 无关联,也未获 OpenAI 认可。