本文へスキップ
Codex DesignBETA

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 のスキルを参照しているので、このフォルダをコピーするのではなく、そのプラグインを使いましょう。

続けて読む

Codex Design は Codex 向けの独立したプラグインです。OpenAI との提携や、OpenAI による承認はありません。