レビューを、組織の判断資産へ。
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—決定とフィードバックを記録し、不要な指摘の再発を抑える。
/plugin marketplace add s977043/river-review
/plugin install river-review@river-review-marketplace
/reload-plugins
/river-review:review-local
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.136.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リポジトリ上で閲覧可能です。ドキュメント管理方針
ESLint・型チェック・静的解析の代わりですか？ いいえ。River Review は計画と実装、テストと期待値など、複数アーティファクトを跨ぐレビュー判断を補完します。
レビュー結果が自動承認になりますか？ いいえ。findings と verdict は判断材料であり、最終承認・GO / NO-GO は人間・呼び出し側の責務です。
その他は FAQ と セキュリティモデル を参照してください。
バグ報告、改善提案、ドキュメントの貢献を歓迎します。
コードは LICENSE-CODE（MIT）、ドキュメントやメディアは LICENSE-CONTENT（CC BY 4.0）を参照してください。ルートの LICENSE 本文は MIT です。ただし設定ファイル等への適用範囲については、LICENSE-CODE / LICENSE-CONTENT の説明に Apache-2.0 への不一致があり、Issue #2721 で確認中です。
