systematic-debugging は何をしますか？
DanhDue/ai-agent-tools のエージェントスキル「systematic-debugging」。
概要
このスキルは、AIエージェントがソフトウェアのバグや問題に体系的にアプローチし、効率的に解決するためのデバッグ手順を定義します。
対象プラットフォーム
- Claude Code
- Cursor
- Codex
- その他AIエージェント
デバッグワークフロー
以下の段階的なプロセスに従ってデバッグを実行します。
1. 問題の再現
- エラーまたは予期しない動作を正確に再現する手順を確認します。
- 再現に必要な環境変数、入力、および設定を特定します。
2. 情報収集
- エラーログ、スタックトレース、および関連する出力を収集します。
- 問題に関連するソースコードとその変更履歴を確認します。
3. 仮説の立案
- 収集した情報に基づいて、考えられる根本原因の仮説を立てます。
- 各仮説に対して、それを検証するための具体的なテストまたはチェックを計画します。
4. 仮説の検証
- 各仮説を順に検証し、結果を記録します。
- テストコードの作成、ログの追加、または条件付きブレークポイントの使用など、適切な手法を選択します。
5. 根本原因の特定
- 検証結果から根本原因を特定し、コード内の正確な位置を特定します。
- なぜその問題が発生したのかを文書化します。
6. 修正の実装
- 根本原因に対する修正を実装します。
- 修正が他の機能に悪影響を及ぼさないことを確認するために、単体テストを追加または更新します。
7. 検証
- 修正後、問題が解決したことを確認するために元の再現手順を実行します。
- 関連するすべてのテストスイートを実行し、回帰がないことを確認します。
チェックリスト
以下のチェックリストを使用して、デバッグプロセスが漏れなく実行されていることを確認します。
- 問題が再現可能であることを確認しましたか？
- エラーログとスタックトレースを収集しましたか？
- 関連するコードとその履歴を確認しましたか？
- 仮説を文書化し、優先順位を付けましたか？
- 各仮説を検証するためのテストを実行しましたか？
- 根本原因を特定し、修正を実装しましたか？
- 修正後に再現手順を再度実行して確認しましたか？
- すべてのテストが合格することを確認しましたか？
注意事項
- デバッグ中は、各ステップで得られた証拠をメモとして残すことを推奨します。
- あまりに多くの仮説を同時に検証しようとせず、一つずつ丁寧に検証してください。
- 必要に応じて、
git bisectなどのツールを使用して変更履歴を効率的に調査します。 - 環境の違い（開発、テスト、本番）による問題の可能性も考慮に入れてください。