systematic-debugging

このスキルは superpowers の原作者によるもので、テストの失敗、本番環境での障害、ビルドエラー、またはその他の異常な挙動が発生した際にトリガーされます。基本ルールは「根本原因の調査を行わなければ、修正を提案してはならない」というものです。第1段階では、完全なエラーメッセージを読み、再現性を確認し、最近の変更点を調べます。複数のコンポーネントからなるシステムでは、各境界にログを追加して、どの層で問題が発生しているかを特定します。第2段階では、正常に動作する類似のコードを探し、項目ごとに比較検討します。第3段階では、一度に1つの仮説のみを検証します。最後に修正を行います。時間がない場合や「一行直すだけでいい」と感じるときほど、このプロセスを最後まで遂行することが求められます。

このスキルは 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つの段階に従って調査を行います。「まず修正せず、この問題の根本原因を特定して」と直接指示することも可能です。

リスク

  • 調査中にコードへ一時的な診断ログを追加し、コマンドを実行することがあるため、終了後にこれらの変更がクリーンアップされていることを確認する必要があります。

開く · リポジトリ

Best Skills 每日数据(LinklyAI / @BlueeonY,CC BY 4.0)

最新の AI ニュースを見る