River Review

レビューを、組織の判断資産へ。
Review Judgment as Code for AI-assisted development.

日本語が正本です。English README

River Review は、レビュー基準を versioned / repo-owned な Skill として管理し、計画・差分・テスト・既存レビューの根拠を横断して実行する OSS です。Claude Code / Codex のローカルレビューと GitHub Actions に、同じチームの判断基準を持ち込めます。人間の承認や自動マージの代行はしません。

• Skills define judgment—チームがレビュー観点を所有し、fixture / golden output で評価する。
• Gates execute judgment—計画・差分・検証証跡を対象に、現在利用可能なレビューゲートで判断基準を適用する。
• Riverbed remembers judgment—決定とフィードバックを記録し、不要な指摘の再発を抑える。

設計思想 / 機能と実行モデル / 既知の制限

はじめる

Claude Code（最短）

/plugin marketplace add s977043/river-review
/plugin install river-review@river-review-marketplace
/reload-plugins
/river-review:review-local

Codex

codex plugin marketplace add s977043/river-review

通常のプラグイン利用では、River Review 専用の LLM API キーは不要です。GitHub Actions や standalone river run のヘッドレス実行では、設定した LLM プロバイダーの API キーが必要です。

導入手順の詳細は プラグインを導入する、GitHub Actions 設定は 5分クイックスタート を参照してください。npm パッケージの公開は配布方針に含まれず、リポジトリ内の開発用 CLI は npm run river -- ... で実行します。

最新リリース: v1.137.0

得られるもの

得られるもの（プラグイン名で名前空間化されます）:

• コマンド: /river-review:setup-team / /river-review:review-local / /river-review:review-team / /river-review:challenge が含まれる。加えて /river-review:skill / /river-review:check / /river-review:pr も使える。

• スキル: オーケストレーターの river-review に加えて river-review-code / river-review-security / river-review-security-audit / river-review-performance の各スキルが含まれる。さらに river-review-architecture / river-review-testing / river-review-frontend も含まれる。加えて river-review-docs / adversarial-review / review-team / unknown-coverage-review も含まれる。いずれも /river-review:<skill-name> で呼び出せる

スキルを追加する前に、Starter Cookbook で既存の観点を試してください。プロジェクト固有の基準は Skill作成チュートリアル に沿って作成できます。

ドキュメント

• 初回導入：Quickstart
• レビュー運用：2段構えレビューゲート
• GitHub Actions：GitHub Actionsガイド
• Skill一覧とスキーマ：Skill Catalog / Schema
• CLIの仕様：CLIリファレンス
• トラブルシューティング：Troubleshooting
• ロードマップ：ROADMAP.md / Issues

公式ドキュメントの正本は pages/ です。docs/ は開発・保守資料であり、公式サイトには掲載しません。ただし両ディレクトリとも公開GitHubリポジトリ上で閲覧可能です。ドキュメント管理方針

FAQ

ESLint・型チェック・静的解析の代わりですか？ いいえ。River Review は計画と実装、テストと期待値など、複数アーティファクトを跨ぐレビュー判断を補完します。

レビュー結果が自動承認になりますか？ いいえ。findings と verdict は判断材料であり、最終承認・GO / NO-GO は人間・呼び出し側の責務です。

その他は FAQ と セキュリティモデル を参照してください。

コントリビューションとセキュリティ

バグ報告、改善提案、ドキュメントの貢献を歓迎します。

• 貢献ガイド / 行動規範
• 脆弱性の非公開報告（公開Issueへ脆弱性情報を投稿しない）
• 公開の実践進化方針

ライセンス

コードは LICENSE-CODE（MIT）、ドキュメントやメディアは LICENSE-CONTENT（CC BY 4.0）を参照してください。ルートの LICENSE 本文は MIT です。ただし設定ファイル等への適用範囲については、LICENSE-CODE / LICENSE-CONTENT の説明に Apache-2.0 への不一致があり、Issue #2721 で確認中です。