review-only reference
review-only は PR または local diff を local AI Agent で 1 回だけ確認し、結果を返す read-only review である。
コード修正や PR への書き込みをせず、finding の採否を人間または別 workflow に渡したい場合に使う。
review-only local は、PR を探さず現在の local diff を対象にする。
使いどころ
- 既存 PR を修正なしでレビューしたい
- PR がない local diff を指定した reviewer で確認したい
- GitHub Copilot bot を起動せず、Codex、Claude、GitHub Copilot CLI の local reviewer だけを使いたい
- finding の修正や再レビューを別の作業として扱いたい
まず何が起きるか
- 明示された 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 |
agents= を省略した場合は現在の runtime に合わせて既定 reviewer を選ぶ。
agents=copilot は GitHub Copilot CLI reviewer であり、GitHub PR 上の Copilot reviewer ではない。
agents=none は review-only では実行経路がないため停止する。
Stop Conditions
review-only は次の操作を行わない。
- ファイル編集、commit、push
- PR コメント、GitHub review comment、thread reply、resolve、close
- 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
Related Docs
- Issue workflow skill guide
- multi-review reference
claude/skills/review-only/SKILL.md