| name | agent-reviewer |
| description | 入力された成果物を分析し、適切な perspectives を自律選択してサブエージェントを並列起動し、集約レビューを返す。「レビューして」「コードを確認して」「設計をレビューして」「ドキュメントをチェックして」「品質確認して」などの依頼で発動。sprint-reviewer は含まない。 |
| metadata | {"version":"3.1.0","tier":"stable","category":"review","tags":["review","orchestration"]} |
agent-reviewer
入力された成果物を分析して適切な perspectives を選択し、perspective ごとに自身をサブエージェントとして並列起動して結果を集約する。
パス解決
このSKILL.mdが置かれているディレクトリを SKILL_DIR とする。
各 perspective の手順は ${SKILL_DIR}/references/ 以下の参照ファイルに定義されている。
perspectives と参照ファイルの対応
| perspective | 参照ファイル | 主な対象 |
|---|
functional | ${SKILL_DIR}/references/functional.md | プロダクションコードの正確性・堅牢性 |
ai-antipattern | ${SKILL_DIR}/references/ai-antipattern.md | AI 生成コード特有の問題 |
architecture | ${SKILL_DIR}/references/architecture.md | モジュール・レイヤー間の構造 |
security | ${SKILL_DIR}/references/security.md | OWASP Top 10・脆弱性・差分SAST |
design | ${SKILL_DIR}/references/design.md | クラス・モジュール設計・SOLID |
test | ${SKILL_DIR}/references/test.md | テストコードの品質・網羅性 |
document | ${SKILL_DIR}/references/document.md | 要件定義書・設計書・仕様書 |
実行プロトコル
Step 1: perspectives の選択と並列起動
⛔ STOP — runSubagent を今すぐ起動する
集約レビューはサブエージェントが行う。このインスタンス自身は直接レビューしない。
perspectives を決定したら即座に runSubagent を呼び出すこと。
対象ファイル・依頼内容から perspectives を決定し、同一ターン内で全 perspective の runSubagent をまとめて起動する:
| 対象・依頼内容 | 使用する perspectives |
|---|
| プロダクションコード（汎用） | functional, ai-antipattern, architecture |
| プロダクションコード + テストファイル混在 | functional, ai-antipattern, architecture, test |
| セキュリティ関連コード（認証・DB・API・入力処理） | functional, ai-antipattern, architecture, security |
| テストコードのみ | test |
| セキュリティ診断・セキュリティレビュー | security |
| クラス・モジュール設計 | design, architecture |
| ドキュメント・仕様書・設計書 | document |
起動テンプレート（各 perspective ごとに runSubagent 1 件。全件を同一ターン内で開始する）:
agent-reviewer スキルで以下をレビューしてください。
手順: まず agent-reviewer スキルの SKILL.md（${SKILL_DIR}/SKILL.md）を読んで手順に従ってください。
perspective: [選択した perspective]
レビュー対象:
変更ファイル: [対象ファイルの一覧]
コンテキスト（あれば）:
[依頼内容・背景]
注意: ユーザーへの確認・対話は行わず、レビューのみ実施すること。
全サブエージェントの完了を待ち、Step 3（集約）へ進む。
Step 2: 単一 perspective のレビュー実行（内部サブエージェント用）
- 内部的に指定された perspective に対応する参照ファイルを読み込む
- 参照ファイルの手順に従ってレビューを実施する
- 参照ファイルで定義された出力形式・判定スキーマで結果を返す
Step 3: 集約
各 perspective は 共通の判定スキーマ を返す:
verdict: LGTM | REQUEST_CHANGESseverity_summary: critical / warning / suggestionblocking_issues[*].severity: Critical | Warning
集約判定ルール:
- 全 perspective が LGTM → 総合判定: LGTM ✅
- いずれかが Request Changes → 総合判定: Request Changes ❌（最も厳しい判定を採用）
集約レポートフォーマット:
## 総合レビュー結果: [LGTM ✅ | Request Changes ❌]
### 実施した perspectives
| perspective | 判定 | Critical | Warning | Suggestion |
|---|---|---|---|---|
| functional | LGTM ✅ / Request Changes ❌ | 0 | 0 | 0 |
| ai-antipattern | ... | | | |
| architecture | ... | | | |
### 重大な指摘（Critical / Warning）
#### [perspective] より
- [severity]: [summary] — [location]
（指摘なしの場合は「なし」）
集約スキーマ（<!-- verdict-json --> で囲んで出力）:
{
"skill": "agent-reviewer",
"verdict": "LGTM | REQUEST_CHANGES",
"blocking": false,
"perspectives_executed": ["functional", "ai-antipattern", "architecture"],
"perspective_results": [
{
"perspective": "functional",
"verdict": "LGTM | REQUEST_CHANGES",
"blocking": false,
"severity_summary": {"critical": 0, "warning": 0, "suggestion": 0}
}
]
スクリプト
${SKILL_DIR}/scripts/ に以下のユーティリティスクリプトが含まれる。
| スクリプト | 用途 |
|---|
diff_analyzer.py | git diff 出力を解析し、レビュー対象ファイルと変更行を構造化する |
pr_comment_formatter.py | レビュー結果 JSON を GitHub PR コメント用 Markdown に変換する |
diff_analyzer.py の使い方:
git diff HEAD~1 | python ${SKILL_DIR}/scripts/diff_analyzer.py
git diff | python ${SKILL_DIR}/scripts/diff_analyzer.py --summary
git diff HEAD~1 | python ${SKILL_DIR}/scripts/diff_analyzer.py --json
pr_comment_formatter.py の使い方:
python ${SKILL_DIR}/scripts/pr_comment_formatter.py --file review_result.json
echo '{...}' | python ${SKILL_DIR}/scripts/pr_comment_formatter.py
ガードレール
| 制限 | 値 |
|---|
| 外部呼び出し時の mode | 集約レビューのみ |
| 並列起動上限 | 最大4 perspectives |
| スキップ | 禁止（指定 / 選択された perspective は必ず実施） |
