with one click
river-reviewer
// River Reviewer のメインエントリポイント。 レビュー依頼の intent classification → 専門 skill 選択 → 実行 → finding verification → feedback classification → fixture / reference / suppression への還元までを束ねる improvement-loop orchestrator。
// River Reviewer のメインエントリポイント。 レビュー依頼の intent classification → 専門 skill 選択 → 実行 → finding verification → feedback classification → fixture / reference / suppression への還元までを束ねる improvement-loop orchestrator。
[HINT] Download the complete skill directory including SKILL.md and all related files
| id | river-reviewer |
| name | river-reviewer |
| description | River Reviewer のメインエントリポイント。 レビュー依頼の intent classification → 専門 skill 選択 → 実行 → finding verification → feedback classification → fixture / reference / suppression への還元までを束ねる improvement-loop orchestrator。 |
| phase | ["upstream","midstream","downstream"] |
| severity | minor |
| applyTo | ["**/*"] |
| tags | ["entry","routing","orchestrator","improvement-loop"] |
| license | MIT |
River Reviewer は「流れに寄り添う」AI レビューエージェントです。 単にレビューを実行するだけでなく、レビュー結果を検証し、フィードバックを分類して fixture / reference / suppression / routing へ還元する継続改善ループ を担います。
このエントリ skill は以下を担う。順序は実行フローと一致する。
review 実行プランを組むときに参照する入力は、以下の優先順で扱う。 上位の入力が下位を上書きする。
plan / diff / test-cases / junit / coverage / review-self / review-external.river/rules.md — リポジトリ固有のレビュー規則.river/risk-map.yaml — リスクマップ.river/ 系が見つからない場合は .claude/rules/ を fallback として使う。
入力に応じて、以下の専門スキルへ案内します。詳細な優先度規則は ROUTING.md。
| キーワード | 専門スキル | 説明 |
|---|---|---|
| 設計, アーキテクチャ, ADR | river-reviewer-architecture | 設計・アーキテクチャレビュー |
| セキュリティ, 脆弱性 | river-reviewer-security | セキュリティ観点レビュー |
| パフォーマンス, 最適化 | river-reviewer-performance | パフォーマンス観点レビュー |
| テスト, カバレッジ | river-reviewer-testing | テスト観点レビュー |
| 敵対的, 壁打ち, バイアス | adversarial-review | 敵対的レビュー(3手法統合) |
| (上記以外) | river-reviewer-code | 一般コード品質レビュー |
デフォルト動作: キーワードがどれにも当てはまらない場合は一般コードレビュー (river-reviewer-code) にフォールバックします。
複数カテゴリ該当時: severity重み → キーワード数 → 入力内位置の順で優先度を解決します。同点時は併用実行します。
1. 入力の intent classification
├─ 明示的なキーワード指定あり → 該当する専門スキルへルーティング
├─ 複数カテゴリに該当 → severity重み → キーワード数 → 入力内位置で優先度解決
└─ キーワードなし → river-reviewer-code(デフォルト)へフォールバック
2. 専門スキルの実行
├─ river-reviewer-architecture: 設計・アーキテクチャ観点
├─ river-reviewer-security: セキュリティ観点
├─ river-reviewer-performance: パフォーマンス観点
├─ river-reviewer-testing: テスト観点
├─ adversarial-review: 敵対的レビュー(3手法統合)
└─ river-reviewer-code: 一般コード品質(フォールバック)
3. Finding verification
└─ VERIFICATION.md の 6 項目 self-check を全件通過したものだけ出力
4. Feedback classification(人間/エージェント返答受領後)
└─ FEEDBACK.md の 7 type で分類
5. Improvement loop handoff
└─ IMPROVEMENT_LOOP.md の 9 ステップに従って fixture / reference / suppression / routing を更新
Finding は以下のフィールドを満たすこと。詳細条件は VERIFICATION.md。
| フィールド | 内容 |
|---|---|
| Finding | 何が問題か(1 文) |
| Evidence | file:line か artifact 参照。差分外の推測は不可 |
| Impact | 何が壊れる / 誰が困るか(具体的に) |
| Fix | 次の最小一手。1 ファイル / 1 関数 / 1 設定値の粒度を起点に |
| Confidence | high / medium / low / unknown |
| Severity | critical / major / minor / info(出力スキーマでは critical→major→minor→info に正規化) |
| Skill ID | どの専門 skill が出した finding か(routing 透明化) |
シンプルな出力フォーマット:
<file>:<line>: <Finding>
Impact: <Impact>
Fix: <Fix>
Severity: <severity> / Confidence: <confidence> / Skill: <skill-id>