systematic-debuggingcommit bb92a77SKILL.md · テスト・デバッグ

体系的デバッグ

根本原因の調査、パターン分析、仮説検証、実装の4段階でバグに取り組み、症状ではなく原因を直します。

npx skills add obra/superpowers --skill systematic-debugging

基本ルール

根本原因の調査を終えるまで、いかなる修正も行わないこと。

フェーズ 01根本原因を調査
エラーを最後まで読み、確実に再現し、最近の変更を確認します。複数コンポーネントでは境界ごとに診断ログを入れ、不正な値の出どころを遡ります。
フェーズ 02パターン分析
コードベース内で動いている類似コードを探し、参照実装を全部読み、壊れたコードとの違いをすべて挙げます。
フェーズ 03仮説と検証
仮説を1つ明確に書き、最小の変更で1変数ずつ検証します。外れたら新しい仮説を立て、修正を重ねません。
フェーズ 04根本原因を修正
再現する失敗テストを先に書き、1つだけ修正して検証します。3回失敗したら止まり、アーキテクチャを人と議論します。

機能	必要か	説明
ファイル書き込み	必要	診断ログの追加、失敗テストの作成、単一の修正ができます。
コマンド実行	必要	問題の再現、テストの実行、git diff や最近のコミットの確認を行います。
外部通信	不要	手順にネットワークアクセスはありません。

SKILL.md のフロントマター（YAML）commit bb92a77

---
name: systematic-debugging
description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
---