Systematic Debugging Skill

Systematic Debugging は Superpowers のスキルです（スキルのソース）。バグ、テスト失敗、想定外の挙動があると、エージェントが修正を提案する前に起動し、「とりあえず変えて様子を見る」を四段階の根本原因調査に置き換えます。

鉄則は「根本原因を調べる前に修正しない」です。

主な機能

• フェーズ 1、根本原因：エラーとスタックトレースを最後まで読み、確実に再現し、最近の変更を確認。複数コンポーネントのシステムでは境界ごとに入出力を記録して壊れている層を特定。
• フェーズ 2、パターン分析：動いている類似コードを探し、参照実装を全部読み、違いをすべて書き出す。
• フェーズ 3、仮説：仮説を一つ述べ（「Y だから X が原因」）、最小の変更で一度に一変数ずつ検証。
• フェーズ 4、修正：まず失敗するテストを書き（TDD スキル）、修正を一つだけ入れて検証。
• 三回ルール：修正が三回失敗したら四回目を試さず、止まってあなたとアーキテクチャを見直す。
• 補助テクニック：根本原因の追跡、多層防御、条件ベースの待機（TypeScript の例付き）、テスト同士の汚染を探す find-polluter.sh。

使用シナリオ

• 不安定なテストや失敗するテスト、ビルド失敗、結合時の問題。
• 時間に追われる本番バグ。スキルは推測に頼りたくなる典型として挙げています。
• 前回の修正が効かなかったとき。

料金

MIT ライセンスの無料オープンソースです。Superpowers を開発する Prime Radiant は企業向けに商用サポートを提供しています。実質的なコストはトークンで、プロセス系スキルは質問、レビュー、サブエージェントの実行を増やします。

はじめに

Superpowers は一つのプラグインとしてインストールされ、このスキルはライブラリ全体（v6.4.1 で 15 スキル）と一緒に入ります。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 にあります。スキルは自動で起動し、名前を指定して呼び出すこともできます。 バグを報告すると、エージェントはコードを編集する前に再現と証拠集めから始めるはずです。

制約：本当に些細なバグには手順が重く、各層に入れる診断ログは後で片付ける必要のある一時的なノイズになります。

よくある質問

エージェントは最終的にバグを直しますか？

はい。原因を説明できるようになったフェーズ 4 で直します。

無限ループを防ぐ仕組みは？

修正が三回失敗したら判断をあなたに戻すルールがあります。

代替案

• Andon：エージェントの欠陥を恒久的な対策に変える。
• Unlazy：大きな作業を実行可能な受け入れゲートで縛る。
• Verification Before Completion：新しい証拠で修正を確認。

まとめ

エージェントにスロットマシンではなく慎重なエンジニアのようにデバッグさせるスキルです。詳しくは skills カテゴリ へ。