Codex の Superpowers systematic debugging スキル。
Superpowers の systematic debugging スキルは、Codex が当てずっぽうで修正するのを止めます。コードを変更する前に、調査し、根本原因を突き止め、失敗するテストを書かなければなりません。Jesse Vincent による Superpowers プラグインに含まれています。
2026年11月12日 更新 · 約 3 分で読めます
概要
| スキル名 | systematic-debugging |
| 提供元 | Jesse Vincent の Superpowers プラグイン |
| インストール | codex plugin add superpowers@openai-curated、または Codex で /plugins |
| Codex が使う場面 | バグ、失敗するテスト、想定外の挙動に出くわしたとき。修正を提案する前 |
| ソース | GitHub の openai/plugins |
できること
このスキルの中心にあるルールは「根本原因を調べるまでは修正しない」です。Codex は 4 つのフェーズを順に進め、それぞれを終えてから次に進みます。
- 根本原因: エラーとスタックトレースを最後まで読み、バグを再現し、最近の変更を確認します。複数の部分からなるシステムでは、各層に出入りするデータをログに出して、どこで壊れるかを確かめます。
- パターン: 正しく動いている似たコードを探し、参考になるコードを最後まで読み、違いをすべて書き出します。
- 仮説: 原因を 1 つとその理由を述べ、できるだけ小さな変更で検証します。うまくいかなければ、修正を重ねるのではなく新しい仮説を立てます。
- 実装: 失敗するテストを書き、原因の箇所で 1 つだけ修正し、ほかに何も壊れていないことを確認します。
修正が 3 回続けて失敗したら、4 回目を試す前に作業を止め、アーキテクチャを疑ってあなたと話し合うよう指示しています。「とりあえず X を変えて様子を見よう」のような、近道のサインになる考えも挙げています。
フォルダには補助のガイドも入っています。コールスタックをたどってバグの出どころを突き止める方法、複数の層にバリデーションを加える方法、固定のタイムアウトを条件のポーリングに置き換える方法です。不要なファイルを残すテストを二分探索で見つける find-polluter.sh スクリプトも付いています。
使いどころ
Codex が症状だけを手当てしたり、修正を積み重ねたり、バグの周りで堂々巡りしたりしがちなら入れましょう。不安定なテスト、ビルドの失敗、複数のコンポーネントにまたがるバグで特に役立ちます。
試してみる
systematic debugging スキルを使ってください。昨日のマージのあとから、checkout のテストが CI で失敗するようになりましたが、ローカルでは通ります。何かを変更する前に、根本原因を突き止めてください。
Claude Code でも使える?
使えます。Superpowers の README には対応エージェントとして Claude Code が載っていて、Claude の公式プラグインマーケットプレイスからインストールできます。このスキルはテスト駆動開発や検証のためのほかの Superpowers のスキルを参照しているので、このフォルダをコピーするのではなく、そのプラグインを使いましょう。