Back to list
takemo101

reviewer-common

by takemo101

0🍴 0📅 Jan 24, 2026

SKILL.md


name: reviewer-common description: 各レビュアーエージェント(backend, frontend, database, security, infra, req, basic-design, detailed-design)の共通設定、動作モード、出力形式、スコアリング基準を定義

レビュアー共通ガイドライン

参照元: 全レビュアーエージェントの共通パターン


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)」を最優先で確認する。

手順:

  1. git diff origin/main...HEAD を読む
  2. 変更されたファイルと行を特定
  3. 文脈が必要な場合のみ read(offset, limit) で周辺を読む
  4. 禁止: 変更がないファイルの全文読み込み

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-reviewer8点以上要件定義
basic-design-reviewer9点以上基本設計
detailed-design-reviewer9点以上詳細設計
backend-reviewer9点以上実装
frontend-reviewer9点以上実装
database-reviewer9点以上実装
security-reviewer9点以上 + Critical/High=0実装
infra-reviewer8点以上複雑性考慮

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 全レビュアー共通

  1. 建設的: 問題だけでなく修正案を必ず提示
  2. 具体的: ファイル名、行番号、コード例を含める
  3. 優先度明示: 修正必須と任意提案を区別
  4. 一貫性: プロジェクトの既存パターンを尊重

5.2 実装レビュアー追加ルール

  • Diff-Driven Review を使用
  • 変更がないファイルの全文読み込み禁止
  • 常に具体的なファイルパスと行番号を提示

5.3 良い指摘例

1. [src/auth/service.ts] 45行目: 認証トークンの検証漏れ
   - 問題: JWT有効期限チェックが未実装
   - 修正案: `jwt.verify()` に `maxAge` を追加
   - 理由: 期限切れトークンでのアクセス許可リスク

5.4 悪い指摘例

1. 認証の実装が不十分  ← 曖昧、修正箇所不明

Score

Total Score

50/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon