debugging について
debuggingは、開発者向けの体系的なデバッグガイドです。エラーの証拠収集から原因の特定、仮説の検証、最小限の修正と回帰確認までを案内します。
主な機能
- 01エラー情報と再現手順の収集
- 02障害箇所の切り分け
- 03根拠に基づく仮説の検証
- 04最小限の修正と動作確認
- 05よくあるエラーパターンの参照
活用シーン
- 01例外、スタックトレース、テスト失敗の調査
- 02予期しない動作の再現と切り分け
- 03性能問題や設定ミスの調査
- 04修正後の回帰確認とCI検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/debuggingを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/debugging-tools.mderror-patterns.mdroot-cause-analysis.md詳細
デバッグ
根本原因分析とデバッグに対する体系的なアプローチです。
使用する場面
- エラーや例外が発生した場合
- 調査が必要なテストの失敗
- コードで予期しない動作が発生した場合
- スタックトレースやエラーメッセージがある場合
- コードが期待とは異なる動作をする場合
- パフォーマンスの問題やバグがある場合
基本原則
- 証拠に基づく：エラーメッセージ、ログ、再現可能な手順に基づいて診断します
- 体系的：構造化されたデバッグプロセスに従います
- 最小限の修正：問題を解決する最小限の変更を実施します
- 解決策を検証する：修正が機能し、リグレッションを引き起こさないことを確認します
デバッグプロセス
体系的なデバッグプロセスに従います。
- エラー情報を取得します（メッセージ、スタックトレース、ログ、環境）
- 再現手順を特定します（最小限の手順、条件、エッジケース）
- 失敗箇所を切り分けます（関数／モジュール、最近の変更、依存関係）
- 仮説を立てて検証します（証拠に基づく体系的なテスト、デバッグログ）
- 最小限の修正を実施します（最小の変更、動作の維持、既存のパターンへの準拠）
- 解決策を検証します（問題の解決、リグレッションがないこと、テストの成功）
詳しい手法については、references/root-cause-analysis.md を参照してください。
戦略的なデバッグログ
エントリーポイントと終了ポイント、状態遷移、条件分岐、外部 API 呼び出し、データ変換にデバッグログを追加します。問題の解決後は、継続的な価値がある場合を除き、ログを削除します。
エラーパターンの認識
一般的なパターンには、null／undefined エラー、型エラー、タイミングの問題、状態の破損、設定の問題があります。詳しいパターンと解決策については、references/error-patterns.md を参照してください。
統合
修正後：
- CI が成功することを確認します（型、テスト、リンター）
- アトミックな変更（修正＋テスト）をステージします
- セマンティックなコミットメッセージを提案します
- コミット前にユーザーに確認します
参考資料
詳しいガイダンスについては、以下を参照してください。
references/root-cause-analysis.md- 体系的な分析手法references/error-patterns.md- 一般的なエラーパターンと解決策references/debugging-tools.md- デバッグツールとテクニック
コメント
Markdown 対応