review-only reference
review-only は PR または local diff を、local AI Agent reviewer だけで単発レビューする入口である。
レビュー結果と artifact を返すだけで、コード修正、PR コメント、GitHub Copilot bot review request、thread 操作、finding triage loop は行わない。
Entry Conditions
次の状況で使う。
- 既存 PR を read-only にレビューしたい
- 現在ブランチの PR、または PR が無い local diff をレビューしたい
- GitHub Copilot bot ではなく、Codex / Claude / GitHub Copilot CLI の local reviewer だけを使いたい
- finding の採否や修正は reviewer 実行後に人間または別 workflow で判断したい
agents= が省略された場合は現在の runtime に合わせて既定 reviewer を選ぶ。
agents=none は review-only では実行経路がないため停止する。
Target Resolution
| 入力 | 対象 |
|---|---|
PR番号 / PR URL |
指定 PR |
local |
現在の local diff |
| 省略 | 現在ブランチの PR。PR が無い場合は local diff |
local diff の起点は未指定なら main で、必要な場合だけ base=branch を指定する。
PR target でも GitHub Copilot bot review request は送らない。
Options
| 引数 | 意味 |
|---|---|
agents=codex |
Codex local reviewer を使う |
agents=claude |
Claude local reviewer を使う |
agents=copilot |
GitHub Copilot CLI local reviewer を使う |
agents=codex,copilot |
複数 local reviewer を使う |
base=branch |
local diff の起点 branch |
per-agent-timeout=15m |
各 local reviewer の timeout |
owner-repo=OWNER/REPO |
review-orchestrator に渡す対象 repo |
task-context-file=<path> |
local target の補足 context |
validation-mode=off|auto |
off では検証しない。auto 明示時だけ検証結果も review output として扱う |
validation-command=<cmd> |
必要な場合だけ検証 command を渡す |
claude-mcp=off|on |
Claude reviewer の MCP policy |
agents=copilot は GitHub Copilot CLI reviewer であり、GitHub PR 上の copilot-pull-request-reviewer ではない。
Stop Conditions
review-only では次の操作を実行しない。
- ファイル編集、commit、push
- PR コメント、GitHub review comment、thread reply / resolve / close
- GitHub Copilot bot review request / wait
multi-review record-action- finding 採否 triage、修正、収束 rerun
review-orchestrator が required action、parse failure、timeout、validation failure を返した場合も、この skill では review result として報告して止める。
CLI 不在、認証不備、対象 PR 解決不能など、review 自体を開始できない状態だけを setup blocker として扱う。
Report
完了報告では次を確認する。
- 対象 PR または
local、base branch、agents multi-review-report.htmlと work-dir- findings / no findings / parse failure / timeout の有無
- review / validation / conflict / follow-up required actions の件数
- GitHub Copilot bot review request、PR comment、thread 操作、code edit を実行していないこと
- validation を実行した場合は command と結果。未実行なら
validation-mode=off
finding が残っていても、単発 review run と artifact 要約までが review-only の完了条件である。
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