plugin-review

プラグインレビュー

概要

依存関係を考慮したスコープ設定による、段階的なプラグイン品質レビューです。

使用しない場合

• プラグインではなく、単一のスキルをレビューする場合（abstract:skills-eval を使用）
• フックをレビューする場合（abstract:hooks-eval を使用）
• プラグイン間の Skill() 参照を追跡する場合（ abstract:skill-graph-audit を使用）

ティア

ティア	トリガー	スコープ	深度	所要時間
branch	デフォルト	影響を受けるプラグインと関連プラグイン	クイックゲート	約2分
pr	マージ前	影響を受けるプラグインと関連プラグイン	標準	約5分
release	バージョン更新前	すべてのプラグイン	完全	約15分

オーケストレーション

1. スコープを検出：--tier フラグを解析し、git diff から影響を受けるプラグインを特定して、docs/plugin-dependencies.json から関連プラグインを解決します
2. 計画：チェックマトリックス（ティア x プラグイン x ロール）を作成します
3. 実行：ティアの定義に従ってチェックを実行します
4. レポート：プラグインごとの表と総合判定を出力します

スコープの検出

影響を受けるプラグイン：git diff main --name-only の結果を plugins/*/ に絞り込みます。

関連プラグイン：docs/plugin-dependencies.json を読み込み、影響を受ける各プラグインの逆引きインデックスを参照して依存元を特定します。これらには「関連」とマークし、軽いチェックを実施します。

--tier release が指定された場合、または git diff を利用できない場合は、すべてのプラグインをスコープとします。

モジュールの読み込み

• 常時：この SKILL.md（オーケストレーションロジック）
• branch ティア：modules/tier-branch.md を読み込みます
• pr ティア：modules/tier-branch.md の後に modules/tier-pr.md を読み込みます
• release ティア：すべてのティアモジュールと modules/tier-release.md を読み込みます
• 依存関係の解決時：modules/dependency-detection.md を読み込みます

判定

結果	意味
PASS	すべてのチェックに合格
PASS-WITH-WARNINGS	ブロック対象ではない問題あり
FAIL	ブロック対象の問題が見つかりました

出力形式

Plugin Review (<tier> tier)
Affected: <list>
Related:  <list> (<reason>)

Plugin          test  lint  type  reg   verdict
<name>          PASS  PASS  PASS  PASS  PASS
...

Verdict: <PASS|PASS-WITH-WARNINGS|FAIL> (N/N plugins healthy)

pr ティアと release ティアでは、スコアカードのセクションが追加されます。

品質ゲートモード

--quality-gate フラグを指定すると、警告と失敗を区別する終了コードを使って CI/CD と統合できます。

• 0：すべての品質ゲートに合格
• 1：警告はありますが、ゲートに合格（ブロック対象ではない）
• 2：品質ゲートの失敗（ブロック対象）
• 3：重大な問題が見つかりました（ブロック対象）

警告をブロック対象として扱うには、--fail-on warning を使用します。

設定

プラグインのルートに .plugin-review.yaml ファイルを配置すると、しきい値と重点領域をカスタマイズできます。

plugin_review:
  quality_gates:
    structure_min: 80
    skills_min: 75
    hooks_min: 70
    tokens_max_total: 50000
    bloat_max_percentage: 15
  focus_areas:
    - skills
    - hooks
    - tokens
  exclude_patterns:
    - "*/legacy/*"
    - "*/deprecated/*"
  severity_overrides:
    missing_description: warning
    large_file: info

使用例の詳細については、/plugin-review コマンドのリファレンスを参照してください。

終了条件

• 出力に、test、lint、type、reg、verdict の列を含むプラグインごとの表と、総合判定 PASS / PASS-WITH-WARNINGS / FAIL が含まれていること。
• スコープの検出で、git diff main --name-only の結果を plugins/*/ に絞り込み、影響を受けるプラグインが特定されること。git diff を利用できない場合は、スキルが全プラグインを対象とするスコープにフォールバックし、その旨を明示すること。
• structure_min（デフォルト値は 80）または skills_min（デフォルト値は 75）のしきい値を下回るスコアのプラグインは、警告ではなく FAIL として列挙されること。
• --quality-gate モードでは、ブロック対象の失敗に対して終了コード 2、ブロック対象ではない警告に対して終了コード 1 が返され、呼び出し元の CI ステップで区別できること。