mcpField
D
debugging

debugging

github.com/mrgoonieテスト・品質2.2k573 回インストール30 週間前に更新
リポジトリ

debugging について

ソフトウェア開発者やエージェント向けのデバッグスキル集です。根本原因の調査、呼び出しスタックの追跡、多層検証、完了前の確認を扱います。

主な機能

  1. 014段階の体系的なデバッグ
  2. 02呼び出しスタックで原因を追跡
  3. 03データの各層で検証
  4. 04完了報告前の動作確認

活用シーン

  1. 01テスト失敗や予期しない動作の調査
  2. 02スタックの深部にあるエラーの特定
  3. 03同じバグの再発防止
  4. 04修正後に結果を確認して報告

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mrgoonie/claudekit-skills --skill debugging

インストール後、Claude Code で/debuggingを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

root-cause-tracing/
find-polluter.sh
systematic-debugging/
CREATION-LOG.md
test-academic.md
test-pressure-1.md
test-pressure-2.md
test-pressure-3.md

詳細

デバッグスキル

修正を試みる前に徹底的な調査を行う、体系的なデバッグ手法のコレクションです。

利用可能なサブスキル

体系的なデバッグ

場所: systematic-debugging/SKILL.md

4 段階のデバッグフレームワークです。根本原因の調査 → パターン分析 → 仮説検証 → 実装の順に進めます。絶対的なルール：根本原因の調査を最初に行わずに修正してはいけません。

根本原因の追跡

場所: root-cause-tracing/SKILL.md

コールスタックをさかのぼってバグを追跡し、最初のトリガーを見つけます。症状を修正するのではなく、不正なデータがどこで発生したかを突き止め、発生源で修正します。

多層防御による検証

場所: defense-in-depth/SKILL.md

データが通過するすべてのレイヤーで検証し、構造的にバグが起こり得ない状態にします。4 つのレイヤー：エントリーポイント → ビジネスロジック → 環境ガード → デバッグ計測。

完了前の検証

場所: verification-before-completion/SKILL.md

成功を主張する前に、検証コマンドを実行し、その出力を確認します。絶対的なルール：新たな検証証拠なしに完了を主張してはいけません。

使用する場面

  • 本番環境でのバグ → systematic-debugging から始めます
  • スタックトレースの深い箇所でのエラー → root-cause-tracing を使います
  • バグの修正 → 根本原因を特定した後、defense-in-depth を適用します
  • 「完了」と主張する直前 → verification-before-completion を使います

クイックディスパッチ

症状サブスキル
テストの失敗、予期しない動作systematic-debugging
エラーが誤った場所に現れるroot-cause-tracing
同じバグが繰り返し発生するdefense-in-depth
修正が機能するか確認する必要があるverification-before-completion

基本理念

「体系的なデバッグは、当てずっぽうで修正を試すよりも速いです。」

実際のデバッグセッションより：

  • 体系的なアプローチ：修正まで 15～30 分
  • 手当たり次第に修正するアプローチ：2～3 時間の試行錯誤
  • 初回で修正できる割合：95% 対 40%

コメント

Markdown 対応