code-review

コードレビュー

状況に合った専門レビューエージェントを呼び出します。モードを選択するか、状況に応じて判断させてください。

レビューモード

クイックレビュー

用途： その場での確認、手早い健全性チェック、ノイズの少ないフィードバック 呼び出すエージェント： quick-reviewer エージェント（信頼度をスコア化し、80 以上のみ報告） 出力： 信頼度の高い問題を重要度別に分類（Critical 90～100、Important 80～89）

詳細レビュー

用途： 機能の完成後、マージ前、計画実行レビューのループ内 呼び出すエージェント： deep-reviewer エージェント（プレースホルダー付きの完全なチェックリスト） プレースホルダー： {WHAT_WAS_IMPLEMENTED}, {PLAN_OR_REQUIREMENTS}, {BASE_SHA}, {HEAD_SHA}, {DESCRIPTION} 出力： 長所、問題（Critical／Important／Minor）、推奨事項、マージ判定

専門レビュー

用途： 特定の品質面に絞った分析 呼び出すエージェント： 次の専門エージェントから 1 つ以上：

エージェント	対象
comment-analyzer	コメントの正確性、ドキュメントの品質、コメントの陳腐化
test-analyzer	テストカバレッジの品質、動作面のカバレッジの不足、テストの堅牢性
silent-failure-hunter	エラー処理、サイレントな失敗、catch ブロックの具体性
type-design-analyzer	型の不変条件、カプセル化、型の有用性

包括的レビュー

用途： main へのマージ前、開発ブランチの完了時 呼び出すエージェント： 4 パス構成（TDD 準拠性、差分のみの品質、コンテキストに沿った品質、ブラウザー監査）。各パスの詳細と実行順序については、references/comprehensive-review-procedure.md を参照してください。

依頼方法

1. scripts/review-prep を使って Git のコンテキストを収集します（ベースブランチを自動検出し、BASE_SHA、HEAD_SHA、差分の統計情報、変更ファイル、コミットログを出力します）。構造化された出力には --json を使います。
2. 選択したエージェントのリファレンスファイルを読みます。
3. プロンプトと review-prep の出力を指定して、general-purpose Task エージェントを起動します。
4. フィードバックに対応します。Critical は直ちに修正し、Important は先に進む前に修正します。

ワークフローとの連携

ワークフロー	レビューモード
plan-execution（タスクごと）	詳細レビュー
plan-execution（バッチ）	詳細レビュー
main へのマージ前	包括的レビュー
その場での確認／行き詰まったとき	クイックレビュー
特定の懸念事項	専門レビュー
GitHub PR のレビューと投稿	github-pr スキル（PR レビュー自動化オーケストレーター）

簡素化モード

レビュー後、機能を変更せずに明瞭さ、一貫性、保守性を高める簡素化パスを任意で実行できます。エージェントプロンプトの全文については、references/simplifier.md を読み、そのプロンプトを指定して、レビュー対象ファイルを対象とする general-purpose Task エージェントを起動してください。

フィードバックへの対応

コードレビューのフィードバック（人間または別のエージェントから）を受け取ったら、構造化された 6 段階の対応パターンに従います。READ、UNDERSTAND、VERIFY、EVALUATE、RESPOND、IMPLEMENT です。表面的に同意せず、実装前に検証し、妥当な場合は技術的な根拠をもって異議を唱えてください。対応パターンの全文、異議を唱える基準、YAGNI の確認、情報源ごとの対応については、references/handling-feedback.md を参照してください。

注意すべき兆候

• 「単純だから」という理由でレビューを省略する
• Critical の問題を無視する
• 未修正の Important の問題を残したまま進める
• 包括的レビューの全パスを順番に実行する（1 と 2 は独立しているため、並行して実行する）
• 包括的レビューの Pass 2 と Pass 3 の重複を排除しない

Reference Files

Agent	Reference
deep-reviewer	references/deep-reviewer.md
quick-reviewer	references/quick-reviewer.md
comment-analyzer	references/comment-analyzer.md
test-analyzer	references/test-analyzer.md
silent-failure-hunter	references/silent-failure-hunter.md
type-design-analyzer	references/type-design-analyzer.md
simplifier	references/simplifier.md
handling-feedback	references/handling-feedback.md