第5回 — レビュースキル /review

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

この回の狙い

• 「作成した成果物をコードレビューする」スキルを自作する
• 差分を観点別にレビューし、重要度（must/should/nits）付きでMD出力する

講義（2h）

1. レビューの観点：正しさ/規約/設計・可読性/テスト/セキュリティ
2. 重要度の付け方：🔴must（必ず直す）/🟡should/🟢nits
3. スキル設計：入力（git diff main...HEAD）→ 観点別レビュー → 出力（.ai/reviews/<branch>.md）
4. 指摘は必ず ファイル:行 ＋修正案。指摘0なら「マージ可」と明記
5. 一次レビュー（AI）と人のゲートレビューの役割分担

ワークショップ（6h）

• .claude/skills/review/SKILL.md を作成（完成版を参考に）
• 第4回の調査を元に小修正を入れたブランチに対し /review を実行
• 指摘の質をチェック（誤検知/見落とし）→ スキルの観点・プロンプトを改善
• CLAUDE.md規約違反をわざと入れ、🔴mustで拾えるか確認

OJT課題

実務のPR/ブランチで /review を使い、レビューMDを残す。

🎯 回のゴール

/review で、差分を重要度付きでレビューしMD出力できる。

講師チェック

• [ ] .ai/reviews/*.md に must/should/nits の指摘
• [ ] 指摘が file:line＋修正案を伴う
• [ ] 規約違反を🔴mustで拾える