第4回 — 調査スキル /investigate

Phase 2｜部品スキル構築 ／ 8時間（講義2h + WS6h）／ GitHub前提

この回の狙い

• 「問題を調査して調査結果をMDで出力する」スキルを自作する
• Issue起点で、原因・対象ファイル・修正方針・影響範囲・確認方法を構造化して残す

講義（2h）

1. なぜ「調査→方針提示」を実装前に切り出すのか（手戻り削減・ゲートレビューの土台）
2. 良い調査レポートの構造：概要/原因/対象ファイル/修正方針/影響範囲/確認方法
3. スキル設計：入力（Issue番号 or 説明）→ 手順（gh issue view→Grep/Glob→再現）→ 出力（.ai/investigations/*.md）
4. 「実装しない」境界を守る（方針まで）

ワークショップ（6h）

• .claude/skills/investigate/SKILL.md を作成（同梱の完成版を参考に）
• 題材の練習Issue（例：削除不具合）に対し /investigate を実行
• 出力MDをレビューし、原因特定の精度を上げる（プロンプト/手順を改善）
• 別Issueでも再現し、スキルの汎用性を確認

OJT課題

実務のIssue1件で /investigate を使い、調査MDを残す。

🎯 回のゴール

/investigate で、Issueから調査結果MDを生成できる（原因・対象・方針・影響・確認方法）。

講師チェック

• [ ] .ai/investigations/issue-*.md が生成される
• [ ] 実装せず方針提示で止まっている
• [ ] gh-commentで貼れる粒度になっている