Communityコーディング&開発github.com

根本原因デバッグ

症状を応急処置するのではなく、根本原因を見つけて修正する体系的なデバッグ手法です。あらゆるバグ、エラー、テスト失敗、予期しない動作に対して使用します。

根本原因デバッグ とは?

このスキルは、「mtai0524/claude-skills」の一部として提供される、根本原因デバッグのための体系的な6ステップ手法です。デバッグのプロセスを再現、特定、仮説、修正、証明、報告の順に分割し、エラーの原因を突き止めて適切に修正することを支援します。このスキルはClaude CodeやCodexなどのAIエージェント上で動作し、エラーの根本原因を特定するまで修正を行わないという厳格なルールに従います。具体的には、エラーの再現手順を明確にし、スタックトレースから問題箇所を特定し、一つの仮説を立てて検証し、影響範囲を考慮した上でソースコードを修正し、テストで修正を証明し、最後に原因・修正・検証方法を簡潔に報告します。これにより、表面的な修正による再発を防ぎ、コードベースの品質を向上させることができます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/mtai0524/claude-skills/tree/HEAD/skills/debug-root-cause

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

根本原因デバッグ は何をしますか?

  1. 再現する: 正確なエラー、スタックトレース、およびそれを引き起こす最小の手順を取得します。再現できない場合は、推測する前にその旨を伝えてください。
  2. 特定する: スタックトレースをたどって失敗行を特定し、そこから逆方向に読み進めて、不正な状態が作成された場所を見つけます。
  3. 仮説を立てる: 原因を一文で述べます。ログ、テスト、またはコードを読んで検証します。原因が確認されるまでは修正を行いません。
  4. 根本で一度だけ修正する: 変更する関数のすべての呼び出し元をgrepします。呼び出し側ごとに修正するのではなく、共有コードを修正します。
  5. 証明する: 修正前に失敗し、修正後に成功するテストを追加または実行し、関連するテストも再実行します。テストプロジェクトがない場合は、影響を受けるプロジェクトをビルドし、コード上で失敗ケースをウォークスルーします。
  6. 報告する: 原因、修正、検証方法の3行で報告します。

禁止事項: エラーを黙らせる、盲目的な try/catch を追加する、または失敗理由を理解せずにリトライすること。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

関連スキル