investigue について
investigueは、コード変更前の調査を段階化するコーディングエージェント向けデバッグスキルです。症状と期待する動作を確認し、ユーザーの承認を得ながら原因の特定から最小限の修正まで進めます。
主な機能
- 01症状と期待する動作の確認
- 02関連コードの特定と再現手順の作成
- 03反証可能な根本原因の仮説を3つ提示
- 04タグ付きログで最有力仮説を検証
- 05原因確認後に最小限の修正を提案
活用シーン
- 01コード変更前のバグ調査
- 02観察可能な予測による原因の絞り込み
- 03デバッグ手順の段階的なユーザー確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/investigueを入力して読み込まれたか確認します。
詳細
始める前に、次の2つがそろっていることを確認してください。
- 症状：具体的に何が起きているか（エラーメッセージ、観察された動作、返された値など）
- 期待される動作：代わりに何が起きるべきか
どちらかが不足している場合は、先に明示的に尋ねてください。
修正に取りかかる前に、次の4つのフェーズを順番に進めてください。各フェーズの最後で停止し、私の承認を待ってください。
PHASE 1：特定して再現する。
症状をもとにコードを調べ（必要に応じて Explore サブエージェントを使用）、原因がありそうな箇所を2〜3個特定してください。それぞれ、理由を1文で添えて列挙してください。次に、このバグを確実に再現する最小限のシナリオを3行で説明してください。確実に再現できない場合は、その旨を伝え、再現するための計画を提案してください。
PHASE 2：根本原因について、優先順位を付けた3つの仮説を立てる。
症状ではなく根本原因について、可能性の高い順に3つの仮説を提案してください。それぞれ、仮説を1文で述べたあと、反証可能な予測を示してください。「この仮説が正しければ、<具体的な観察結果> が見られる。逆の結果が見られれば、この仮説は除外できる」という形式にしてください。
PHASE 3：仮説 #1 を検証する。
仮説 #1 を検証するため、対象を絞ったログを追加してください。後でまとめて削除できるよう、各ログの先頭に [DEBUG-a4f2]（ランダムな4文字）というタグを付けてください。このフェーズでは修正案を提示しないでください。確認または否定するために何を観察すべきかを教えてください。
3回失敗したら打ち切るルール：3つの仮説がすべて誤りだった場合は停止してください。もはやコードのバグではなく、アーキテクチャの問題です。別の角度から検討します。
PHASE 4：最小限の修正。
仮説が確認できたら、根本原因に対処するための最小限の変更を提案してください。付随的な最適化や、ついでのリファクタリングは行わないでください。症状ではなく根本原因を説明するコミットメッセージを作成してください。