review-only reference
review-only は PR または local diff を local AI Agent で 1 回だけ確認し、結果を返す read-only review である。
既定ではコード修正や PR への書き込みをせず、finding の採否を人間または別 workflow に渡したい場合に使う。
post=pending を明示した時だけ、finding を自分の pending review(下書き review)に追加する。
review-only local は、PR を探さず現在の local diff を対象にする。
使いどころ
- 既存 PR を修正なしでレビューしたい
- PR がない local diff を指定した reviewer で確認したい
- GitHub Copilot bot を起動せず、Codex、Claude、GitHub Copilot CLI の local reviewer だけを使いたい
- finding の修正や再レビューを別の作業として扱いたい
- finding を PR の下書き review に置き、公開するかどうかを GitHub 上で自分で決めたい
まず何が起きるか
- 明示された PR または
localを対象にする。引数がなければ現在 branch の PR を探し、なければ local diff を使う。 agents=で選んだ local reviewer を read-only で 1 回実行する。- finding、timeout、parse failure、validation failure を含む結果を report にまとめる。
- finding が残っていても修正や再レビューへ進まず、利用者へ返す。
Target Resolution
| 入力 | 対象 |
|---|---|
PR番号 / PR URL |
指定 PR |
local |
現在の local diff |
| 省略 | 現在 branch の PR。PR がなければ main 起点の local diff |
PR target の reviewer が読む checkout は PR head に一致させる。 安全に一致させられない場合は reviewer を起動せず、current HEAD、PR head、原因、次に取る操作を報告する。
Options
| 引数 | 意味 |
|---|---|
agents=codex |
Codex local reviewer を使う |
agents=claude |
Claude local reviewer を使う |
agents=copilot |
GitHub Copilot CLI local reviewer を使う |
agents=codex,copilot |
複数の local reviewer を使う |
agents=none |
review 経路がないため停止する |
base=branch |
local diff の起点 branch |
per-agent-timeout=15m |
reviewer ごとの timeout |
owner-repo=OWNER/REPO |
対象 repository |
task-context-file=<path> |
reviewer に渡す補足 context |
validation-mode=off / validation-mode=auto |
検証を実行しないか、review 結果に検証結果も含めるかを選ぶ |
validation-command=<cmd> |
実行する検証 command |
claude-mcp=off / claude-mcp=on |
Claude reviewer の MCP policy |
post=pending |
finding を自分の pending review へ追加する。PR target 専用で、local とは併用できない |
agents= を省略した場合は現在の runtime に合わせて既定 reviewer を選ぶ。
agents=copilot は GitHub Copilot CLI reviewer であり、GitHub PR 上の Copilot reviewer ではない。
agents=none は review-only では実行経路がないため停止する。
post=pending
post=pending を指定しない限り、PR へは何も書き込まない。
指定した時は、review 後に finding を日本語の本文へ整形し、work-dir の comments.jsonl に保存して review-orchestrator post-pending-review を 1 回だけ呼ぶ。
post=pending と local を同時に指定した場合は、review を始めずに停止する。
finding が 0 件の場合は post-pending-review を呼ばず、投稿対象なしと報告する。
一部の reviewer が parse failure や timeout になった場合は、取得できた finding だけを投稿する。
投稿した finding は投稿者本人にしか見えず、submit は行わない。
partial や error で終わっても再実行しない。報告には items の置き先と、submit していないことが含まれる。
pending review が残っている間に review-orchestrator reply / close-thread を使うと、返信後の submit で下書きの finding も一緒に公開される。
CLI の入力形式と結果は review-orchestrator の post-pending-review を参照する。
Stop Conditions
review-only は次の操作を行わない。
- ファイル編集、commit、push
- PR コメント、GitHub review comment、thread reply、resolve、close(
post=pendingの pending review への追加を除く) - pending review の submit
- GitHub Copilot bot review request
- finding の採否記録、修正、収束 rerun
PR target でも GitHub Copilot bot review request は送らない。 validation を実行した場合も、失敗を修正せず review result として報告する。
結果の読み方
完了報告では対象、base branch、agents、review report、finding 数、失敗した reviewer、validation 結果を確認する。
multi-review-report.html は reviewer の結果を確認するための画面であり、finding が残っていても単発 review attempt 自体は完了できる。
timeout、invalid output、refusal は finding なしに含めない。 また、review attempt の完了を merge-ready や PR-ready と読み替えない。
停止後の対応
- finding がある: 呼び出し元で採否を決め、必要なら修正、検証、再レビューを別途行う。
- validation failure: failure を review result として引き継ぎ、修正する workflow を選ぶ。
- reviewer の起動に失敗した: CLI、認証、許可、target 解決を直して同じ selector で再実行する。
- timeout や parse failure: reviewer を開始できたかと artifact の状態を確認し、finding なしとして先へ進まない。
Examples
/review-only
/review-only local agents=codex base=main
/review-only 123 agents=codex,copilot validation-mode=auto
/review-only 123 post=pending
Related Docs
- Issue workflow skill guide
- multi-review reference
claude/skills/review-only/SKILL.md