majiayu000 レビュアー共通ガイドライン
参照元: 全レビュアーエージェントの共通パターン
1. 共通設定
1.1 Frontmatter テンプレート（実装レビュアー用）
---
description: {専門領域}を専門的にレビューする{ペルソナ}
mode: subagent
model: google/antigravity-gemini-3-pro
temperature: 0.2
tools:
read: true
glob: true
grep: true
mcp__container-use__environment_file_read: true
mcp__container-use__environment_file_list: true
write: false
edit: false
bash: false
---
1.2 Frontmatter テンプレート（設計レビュアー用）
---
description: {設計書種別}をレビューし10点満点でスコアリングする
model: google/antigravity-gemini-3-pro
mode: subagent
temperature: 0.2
tools:
read: true
glob: true
grep: true
write: false
edit: false
bash: false
---
2. 共通動作モード
2.1 モード切り替え
| モード | 対象 | 目的 |
|---|---|---|
| Mode A: 設計レビュー | *設計書.md |
設計フェーズでの品質保証 |
| Mode B: 実装レビュー | ソースコード、Git Diff | 実装コードの品質保証 |
2.2 Diff-Driven Review (Mode B)
Token最適化: 実装レビュー時は、必ず「差分（Diff）」を最優先で確認する。
手順:
git diff origin/main...HEADを読む- 変更されたファイルと行を特定
- 文脈が必要な場合のみ
read(offset, limit)で周辺を読む - 禁止: 変更がないファイルの全文読み込み
3. 共通出力形式
3.1 実装レビュー出力
## {専門領域}実装レビュー結果
### スコア: X/10点
### 各項目の評価
| 項目 | スコア | 詳細 |
|------|--------|------|
| {観点1} | 0-N | ... |
| {観点2} | 0-N | ... |
### 指摘事項（修正必須）
1. [ファイル名] 行番号: 問題の説明
- 問題:
- 修正案:
- 理由:
### 判定
[PASS / FAIL] (9点以上で合格)
3.2 設計レビュー出力
## レビュー結果
### スコア: X/10点
### 各項目の評価
| 項目 | スコア | 詳細 |
|------|--------|------|
| {観点1} | 0-N | コメント |
| {観点2} | 0-N | コメント |
### 問題点
1. [重大度: 高/中/低] 問題の説明
- 該当箇所:
- 修正提案:
### 改善提案
- 提案1
- 提案2
### 良い点
- 良い点1
### 合格判定: [合格/不合格]
3.3 最終出力（全レビュアー共通）
SCORE: [数値]/10
PASSED: [true/false]
4. スコアリング基準
参照: 合格閾値の正式定義は @.claude/skills/workflow-phase-convention/SKILL.md §レビュースコア閾値を参照
4.1 合格閾値
| レビュアー | 合格閾値 | 備考 |
|---|---|---|
| req-reviewer | 8点以上 | 要件定義 |
| basic-design-reviewer | 9点以上 | 基本設計 |
| detailed-design-reviewer | 9点以上 | 詳細設計 |
| backend-reviewer | 9点以上 | 実装 |
| frontend-reviewer | 9点以上 | 実装 |
| database-reviewer | 9点以上 | 実装 |
| security-reviewer | 9点以上 + Critical/High=0 | 実装 |
| infra-reviewer | 8点以上 | 複雑性考慮 |
4.2 配点ガイドライン
| 合計点 | 領域数 | 推奨配点例 |
|---|---|---|
| 10点 | 4領域 | 3+3+2+2 |
| 10点 | 5領域 | 2+2+2+2+2 |
4.3 スコア定義（2点満点の場合）
| スコア | 状態 | 説明 |
|---|---|---|
| 2点 | 優秀 | 完璧またはそれに近い |
| 1点 | 普通 | 基本要件は満たす |
| 0点 | 不十分 | 重大な問題あり |
4.4 重大度定義
| 重大度 | 説明 |
|---|---|
| 高 | 根幹に関わる問題。修正必須 |
| 中 | 品質に影響。修正推奨 |
| 低 | 軽微。修正でより良くなる |
5. 共通ルール
5.1 全レビュアー共通
- 建設的: 問題だけでなく修正案を必ず提示
- 具体的: ファイル名、行番号、コード例を含める
- 優先度明示: 修正必須と任意提案を区別
- 一貫性: プロジェクトの既存パターンを尊重
5.2 実装レビュアー追加ルール
- Diff-Driven Review を使用
- 変更がないファイルの全文読み込み禁止
- 常に具体的なファイルパスと行番号を提示
5.3 良い指摘例
1. [src/auth/service.ts] 45行目: 認証トークンの検証漏れ
- 問題: JWT有効期限チェックが未実装
- 修正案: `jwt.verify()` に `maxAge` を追加
- 理由: 期限切れトークンでのアクセス許可リスク
5.4 悪い指摘例
1. 認証の実装が不十分 ← 曖昧、修正箇所不明