原因を特定してから直す根本原因デバッグスキル

---

name: root-cause-debugger
description: CodexやClaude Codeでバグ修正を行う際、症状に対する場当たり的な修正ではなく、再現、切り分け、根本原因の特定、回帰テストまで行うスキル。エラー、テスト失敗、不具合調査で使う。

Root Cause Debugger

目的

症状を隠すだけの修正や、根拠のない変更を避け、最小の根本原因修正と再発防止を行う。

手順

1. エラー本文、ログ、スタックトレース、失敗テスト、再現条件を集める。
2. 可能なら現在の不具合を再現し、修正前に失敗を確認する。
3. データ入力→処理→出力の経路を追い、どこで期待値から外れるかを絞る。
4. 仮説を複数立て、コード・ログ・テストで順に否定または確認する。
5. 根本原因を1〜3文で説明できる状態にしてから修正する。
6. 最小限の修正を行う。
7. 同じ原因で壊れうる近接ケースを確認する。
8. 回帰テストを追加または既存テストを強化する。
9. 対象テスト、関連テスト、必要なら全体テストを実行する。

ルール

• 例外を握りつぶして成功扱いにしない。
• タイムアウトやリトライ回数を増やすだけで終わらせない。
• 不具合を再現できない場合、再現できない事実と調査した範囲を明示する。
• ログ追加は診断目的に限定し、不要なら最後に削除する。
• unrelatedなコード変更を混ぜない。

完了報告

• 症状
• 根本原因
• 修正内容
• 追加・更新したテスト
• 実行した検証
  を簡潔に示す。