mcpField
E
evidence-first-debugging

evidence-first-debugging

github.com/jamie-bitflight開発35 回インストール
リポジトリ

evidence-first-debugging について

ソフトウェア調査を行うエージェント向けのスキルです。証拠、因果関係の検証、確認ゲートに沿ってデバッグや性能分析を構成し、共通テンプレートと領域別拡張で出力を規定します。

主な機能

  1. 01共通調査テンプレートと証拠ID
  2. 02観察記録と因果関係の検証
  3. 03ソフトウェア障害向け拡張
  4. 04性能回帰向け拡張
  5. 05仮説に反証可能なテストを要求
  6. 06検証結果に基づく状態設定

活用シーン

  1. 01ソフトウェアクラッシュ調査の所見整理
  2. 02レイテンシ、スループット、メモリ回帰の分析
  3. 03観察事実と検証対象の仮説の区別

インストール

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

$npx skills add https://github.com/jamie-bitflight/claude_skills --skill evidence-first-debugging

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

同梱ファイルreferences/shared-references.md

詳細

エビデンス優先のデバッグ

主な責務：観測記録、エビデンス ID、因果関係の検証、検証ゲート。

共通リファレンス

調査結果を出力する前に、これらのリファレンスを読み込んでください。すべての共通ファイルの概要をすばやく確認できるリファレンス索引も用意されています。

ドメイン拡張

調査の種類に該当する拡張機能を読み込んでください。拡張機能のセクションは、セクション 2（OBSERVATIONS）の直後に挿入します。

flowchart TD
    Start([Identify investigation type]) --> Q1{Software bug or crash?}
    Q1 -->|Yes| Dbg["Load [Debugging Extensions](../../shared/extensions/debugging-extensions.md)<br>Adds: CALL STACK, RECENT CODE CHANGES, DEPENDENCY GRAPH after section 2"]
    Q1 -->|No| Q2{Latency, throughput, or memory regression?}
    Q2 -->|Yes| Perf["Load [Performance Extensions](../../shared/extensions/performance-extensions.md)<br>Adds: BASELINE METRICS, REGRESSION WINDOW, HOT PATH ANALYSIS, RESOURCE UTILIZATION after section 2"]
    Q2 -->|No| Neither[Proceed with base template only]

絶対に守るべきルール

すべての調査結果の出力で、例外なく次のルールを徹底してください。

ルール 1 — FACTS / OBSERVATIONS / RESULTS には事実のみを記載する

直接観測したシグナルのみを記述してください。因果関係を示す表現が許可されるのは、因果関係ゲートの分類が causal-supported の場合に限ります。推測、解釈、憶測は記載しないでください。

ルール 2 — すべての仮説に明示的なラベルを付ける

すべての仮説には、何を予測するかを明記し、反証可能なテストを含めてください。次の形式を使用します。

H1: [specific causal mechanism]
  Prediction: If H1 is true, we would observe [specific outcome]
  Falsification test: [what would disprove H1]

ルール 3 — 検証済みの結果に限り resolved-verified を使用する

セクション 13（Verification）に、エビデンス ID を伴う検証コマンドの成功結果が含まれている場合に限り、status: resolved-verified を出力してください。セクション 13 が存在しないか空の場合、ステータスは mitigated、unresolved、または unknown にしてください。

ルール 4 — すべての主張にエビデンス ID を付ける

FACTS または RESULTS のすべての文は、末尾に角括弧で囲んだエビデンス ID を付けてください。例：[E3]。引用可能なエビデンス ID がない文には、UNKNOWN のラベルを付けてください。

ルール 5 — 切り詰めた出力をすべて開示する

出力を省略した場合は、スニペットの直後に切り詰めの開示ブロックを含めてください。

TRUNCATED
total lines: <N>
shown: <M>
method: head | tail | grep
fingerprint: <sha256 or key tokens>
command: <exact command used>

何も伝えずに省略することは禁止されています。

ステータスの選択肢

各調査結果の出力につき、1 つだけ選択してください。調査テンプレートのセクション 14 に記載します。

flowchart TD
    Start([Choose investigation status]) --> Q1{Is the issue resolved?}
    Q1 -->|No — still occurring| Unresolved[status: unresolved]
    Q1 -->|Partially — symptoms reduced but root cause unknown| Mitigated[status: mitigated]
    Q1 -->|Yes — fix applied| Q2{Does section 13 contain a passing verification command with evidence?}
    Q2 -->|Yes| Verified[status: resolved-verified]
    Q2 -->|No — verification missing or inconclusive| Unknown[status: unknown]

出力チェックリスト

調査結果を出力する前に、すべての項目を確認してください。

  • 共通リファレンスを読み込み済み（調査テンプレート、エビデンスのルール、因果関係ゲート）
  • 該当する場合はドメイン拡張機能を読み込み済み（デバッグまたはパフォーマンス）
  • すべての FACTS と RESULTS に角括弧で囲んだエビデンス ID を付記済み
  • すべての仮説に明示的なラベルを付け、反証テストを含めた
  • 切り詰めた出力すべてに TRUNCATION 開示ブロックを含めた
  • セクション 10 のすべてのアクションと結果の関連付けに、因果関係ゲートの分類を記載済み
  • ステータスが有効な 4 つの選択肢のうち、ちょうど 1 つである
  • resolved-verified は、セクション 13 に成功した検証エビデンスが含まれる場合に限り使用

コメント

Markdown 対応