agent-reviewer

agent-reviewer

入力された成果物を分析して適切な perspectives を選択し、perspective ごとに自身をサブエージェントとして並列起動して結果を集約する。

パス解決

このSKILL.mdが置かれているディレクトリを SKILL_DIR とする。 各 perspective の手順は ${SKILL_DIR}/references/ 以下の参照ファイルに定義されている。

perspectives と参照ファイルの対応

実行プロトコル

Step 1: perspectives の選択と並列起動

⛔ STOP — runSubagent を今すぐ起動する

集約レビューはサブエージェントが行う。このインスタンス自身は直接レビューしない。 perspectives を決定したら即座に runSubagent を呼び出すこと。

対象ファイル・依頼内容から perspectives を決定し、同一ターン内で全 perspective の runSubagent をまとめて起動する:

起動テンプレート（各 perspective ごとに runSubagent 1 件。全件を同一ターン内で開始する）:

agent-reviewer スキルで以下をレビューしてください。

手順: まず agent-reviewer スキルの SKILL.md（${SKILL_DIR}/SKILL.md）を読んで手順に従ってください。

perspective: [選択した perspective]

レビュー対象:
  変更ファイル: [対象ファイルの一覧]

コンテキスト（あれば）:
  [依頼内容・背景]

注意: ユーザーへの確認・対話は行わず、レビューのみ実施すること。

全サブエージェントの完了を待ち、Step 3（集約）へ進む。

Step 2: 単一 perspective のレビュー実行（内部サブエージェント用）

1. 内部的に指定された perspective に対応する参照ファイルを読み込む
2. 参照ファイルの手順に従ってレビューを実施する
3. 参照ファイルで定義された出力形式・判定スキーマで結果を返す

Step 3: 集約

各 perspective は 共通の判定スキーマ を返す:

• verdict: LGTM | REQUEST_CHANGES
• severity_summary: critical / warning / suggestion
• blocking_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}
    }
  ],
  "aggregated_blocking_issues": [
    {
      "from_perspective": "functional",
      "severity": "Critical | Warning",
      "summary": "問題の要約（1行）",
      "location": "ファイル名:行番号"
    }
  ]
}

スクリプト

${SKILL_DIR}/scripts/ に以下のユーティリティスクリプトが含まれる。

diff_analyzer.py の使い方:

# diff を解析してレビューコンテキストを出力
git diff HEAD~1 | python ${SKILL_DIR}/scripts/diff_analyzer.py

# サマリーのみ表示
git diff | python ${SKILL_DIR}/scripts/diff_analyzer.py --summary

# JSON 形式で出力
git diff HEAD~1 | python ${SKILL_DIR}/scripts/diff_analyzer.py --json

pr_comment_formatter.py の使い方:

# レビュー結果 JSON を PR コメント形式に変換
python ${SKILL_DIR}/scripts/pr_comment_formatter.py --file review_result.json

# stdin から読み込み
echo '{...}' | python ${SKILL_DIR}/scripts/pr_comment_formatter.py

ガードレール