用途:对 Flow 的 spec 计划与设计文档做 John Carmack 级别的严格评审,由技能充当评审协调者而非评审者,实际评审交给所选后端。触发方式为 /flow-next:plan-review,参数格式为 <flow-spec-id> [focus areas]。
主要能力:支持三种后端——RepoPrompt(rp,macOS GUI,主后端)、Codex CLI(codex,跨平台,默认 gpt-5.5)、GitHub Copilot CLI(copilot,跨平台,支持 Claude Opus/Sonnet/Haiku 4.5 与 GPT-5.2 系列)。后端选择优先级为 --review 参数 > FLOW_REVIEW_BACKEND 环境变量 > .flow/config.json 的 review.backend,不做自动探测;未配置时报错并提示运行 /flow-next:setup。支持 backend[:model[:effort]] 规格语法,如 codex:gpt-5.2、copilot:claude-opus-4.5:xhigh。
使用方式:flowctl 为内置脚本,需用 FLOWCTL="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/flowctl" 调用,which flowctl 会失败属预期。Codex 与 Copilot 后端分别使用 $FLOWCTL codex plan-review 与 $FLOWCTL copilot plan-review,可传 --files 指定评审上下文代码文件,--receipt 保持会话连续性;输出含 VERDICT=SHIP|NEEDS_WORK|MAJOR_RETHINK。RepoPrompt 后端须先执行 workflow.md 中的 RepoPrompt Backend Workflow,使用 setup-review 原子完成窗口选择与 builder,chat-send 不得加 --json,复审须在同一 chat 中省略 --new-chat。评审前可用 $FLOWCTL checkpoint save 保存恢复点。
限制:禁止自行评审或模拟评审结果,禁止在无后端裁决时自宣 SHIP,禁止中途混用后端,禁止在 backend 为 none 时未经用户同意跳过评审;任何失败输出 <promise>RETRY</promise> 并停止。NEEDS_WORK 时内部循环修复并复审,不向用户请求确认。Copilot 会话仅在先前 receipt 的 mode == "copilot" 时才能恢复。其余细节暂未提供。