multi-review reference

multi-review は PR または local diff を対象に、local reviewer、Copilot bot、validation、conflict、CI follow-up を gate として収束させる review workflow である。 詳細な実行状態は review-orchestrator multi-review run の stdout JSON、multi-review-evidence.json、multi-review-events.jsonl、report を source of truth とする。

Target

target 入口 用途
PR target /multi-review 123 agents=codex PR 上の Copilot bot review、local reviewer、thread drain、CI follow-up を収束させる
local target /multi-review local agents=codex validation-command="go test ./..." PR を作らず current diff を local validation と local reviewer で確認する
pre-pr local target review=on の実装系 skill から呼ばれる PR 作成前、または PR 後の追加修正 push 前に local validation と local reviewer を収束させる

PR target と local target は混ぜない。PR target は root --pr <ref>、local target は multi-review run --local を使う。 pre-pr local target では --validation-command または --validation-profile が必要で、GitHub Actions CI や Copilot bot は要求しない。

Reviewer Options

引数 意味
agents=codex Codex local reviewer を使う
agents=claude Claude local reviewer を使う。Codex runtime では direct PTY transport が使われる
agents=copilot GitHub Copilot CLI local reviewer を使う。GitHub PR 上の Copilot bot ではない
agents=none local reviewer を使わない。PR target では Copilot bot review だけを期待する

agents= は local reviewer の選択であり、Copilot bot review の有効化ではない。 agents=copilot と copilot-pull-request-reviewer は別経路なので、agents=copilot を理由に Copilot bot を省略しない。

Simplify Options

引数 意味
simplify=auto 選択 runtime から 1 つを選び、broad simplify を実行する default
simplify=full 選択 runtime ごとに code-reuse / quality / efficiency の観点別 simplify を実行する
simplify=off simplify reviewer を起動しない。report には skip reason が残る

simplify= は local reviewer runtime の選択ではなく、review loop 内の simplify coverage を制御する。

Timing Options

引数 意味
pause=15m PR target の Copilot bot wait に使う待機幅
per-agent-timeout=15m local reviewer 1 job あたりの上限
quiescence=8m PR target の Copilot bot wait で静止判定に使う時間。review-orchestrator では root flag として subcommand より前に置く

これらはユーザーが明示した場合だけ渡す。未指定値は review-orchestrator の default として evidence / report に記録させる。 外側の timeout command で review-orchestrator multi-review run を包まない。

Copilot Bot Options

引数 意味
no-copilot-bot PR target で Copilot bot review を起動しない。ユーザー明示時だけ使う coverage override
force-copilot-request 最新 HEAD に Copilot bot review を強制再依頼する
allow-disable-copilot-bot 過去 run で期待された Copilot bot coverage の無効化を許可する
disable-copilot-bot-reason=<text> coverage を下げる理由を evidence に残す

no-copilot-bot は timeout、API error、local reviewer の成功、agents=copilot を理由に自動付与しない。 Copilot bot を有効にした PR target では、最新 PR HEAD の finalized review と summary が完了条件になる。

Validation Options

引数 意味
validation-command=<cmd> local validation command を明示する。複数指定できる
validation-profile=<path> repo-local validation profile を使う
validation-mode=auto profile や repo から validation を推定する
validation-mode=off local validation を無効化する

pre-pr local target では validation-command または validation-profile を明示する。 standalone local target は推定 fallback を許可するが、unknown のままなら validation gate の required action として扱う。

Worker Compatibility Options

引数 意味
worker-mode=one-shot|prefer legacy worker relay 用の互換 option
worker-helper=<path> legacy worker helper path
worker-project-path=<path> legacy worker project path
worker-lifecycle=close|keep legacy worker lifecycle
claude-mcp=off|on Claude reviewer 起動時の MCP policy

通常の Codex runtime からの Claude reviewer は direct PTY transport を使うため、worker 系 option は基本的に不要である。 host-local な runtime 設定は .multi-review.json ではなく ${XDG_CONFIG_HOME:-$HOME/.config}/agent-dotfiles/agent-runtime.json に置く。

E2E Option

e2e=final が明示された場合だけ、review loop 収束後に E2E gate を実行する。 未指定時は E2E を実行しない。E2E の requested / resolved mode と feasibility の考え方は e2e-workflow-gate reference を参照する。

Stopping Combinations

組み合わせ 理由
pre-pr local target で validation policy 未指定 reviewer に渡す local validation evidence がない
PR target で agents=none no-copilot-bot local reviewer と Copilot bot の両方が無効で review path がない
local target で PR 専用 option を消費しようとする pause、quiescence、Copilot bot request 系は PR target 専用

Completion Conditions

実行開始後は option combination ではなく gate state で判断する。 gates.review.required_actions、gates.validation.required_actions、gates.conflict.required_actions が残っている場合は未収束である。 current reviewer の timeout / parse failure は no findings 扱いせず、artifact finality が収束するまで required action として扱う。

Examples

review-orchestrator --pr 123 multi-review run --agents codex
review-orchestrator multi-review run --local --agents codex --validation-command "go test ./internal/..."
review-orchestrator multi-review run --local --local-phase pre-pr --base-branch main --agents codex --task-context-file <task-context-file> --validation-command "go test ./internal/..."
review-orchestrator --pr 123 multi-review run --agents none