このスキルは superpowers の原作者によるもので、テストの失敗、本番環境での障害、ビルドエラー、またはその他の異常な挙動が発生した際にトリガーされます。基本ルールは「根本原因の調査を行わなければ、修正を提案してはならない」というものです。第1段階では、完全なエラーメッセージを読み、再現性を確認し、最近の変更点を調べます。複数のコンポーネントからなるシステムでは、各境界にログを追加して、どの層で問題が発生しているかを特定します。第2段階では、正常に動作する類似のコードを探し、項目ごとに比較検討します。第3段階では、一度に1つの仮説のみを検証します。最後に修正を行います。時間がない場合や「一行直すだけでいい」と感じるときほど、このプロセスを最後まで遂行することが求められます。
なぜ重要か エージェントがバグを修正する際によくある問題は、症状を見て即座に変更を加え、うまくいかなければさらに別の層を追加してしまうことです。このスキルは、調査、比較、仮説の検証、修正という4つの段階を必ず順に踏むよう強制します。
skills.sh のインストール数 333427(+1239 / 24時間あたり)
セキュリティ監査:リスクに関する注意喚起あり
- エージェントが shell / スクリプトコマンドを実行する可能性がある
- 監査対象範囲:GitHub obra/superpowers/skills/systematic-debugging/SKILL.md(SKILL.md のテキストのみをスキャン)
理由
- skills.sh では 24 時間でインストール数が 1239、累計で 333427 に達している(これは注目度を示すに過ぎない)。ライセンスは MIT。
- 監査で指摘されたコマンド実行は、調査段階で使用される git diff やログ追加によるトラブルシューティングであり、用途と一致している。これは obra の元のリポジトリであり、コピーアカウントではない。
使い方
- インストール後、エージェントがエラーやテスト失敗に遭遇すると、自動的に4つの段階に従って調査を行います。「まず修正せず、この問題の根本原因を特定して」と直接指示することも可能です。
リスク
- 調査中にコードへ一時的な診断ログを追加し、コマンドを実行することがあるため、終了後にこれらの変更がクリーンアップされていることを確認する必要があります。