用途:对当前分支相对 main/master 的实现改动做深入审查(描述为 John Carmack 级别),可用于代码变更、PR 或实现评审。角色为代码审查协调者,自身不评审代码,由 OpenCode 或 RepoPrompt(rp)后端完成。
主要能力:支持多种后端选择,优先级为 --review=rp|opencode|export|none 参数、FLOW_REVIEW_BACKEND 环境变量、.flow/config.json 的 review.backend、交互式提示,默认 opencode。OpenCode 后端通过 flowctl opencode impl-review 执行,可用 --base 指定 diff 范围、--receipt 保持会话连续性,输出 VERDICT=SHIP|NEEDS_WORK|MAJOR_RETHINK。RepoPrompt 后端需 rp-cli 且要求 RepoPrompt 1.6.0+,使用 builder review 模式,流程为识别改动、setup-review 原子设置、select-add 补充选择、chat-send 发送审查提示、按需写 receipt。
使用方式:flowctl 是捆绑的,不全局安装,需用 OPENCODE_DIR/bin/flowctl。示例:ROOT="$(git rev-parse --show-toplevel)";FLOWCTL="$ROOT/.opencode/bin/flowctl"。r 后端重审必须留在同一聊天,首次之后省略 --new-chat;chat-send 不得加 --json;有 REVIEW_RECEIPT_PATH 时审查后写回执。失败输出 <promise>RETRY</promise> 并停止。
修复循环:结论为 NEEDS_WORK 时按 Critical、Major、Minor 解析问题,修复代码并跑测试与 lint,提交后重审,直到 SHIP。
限制与禁止:不得自行宣布 SHIP 而无实际后端结论;不得中途混用后端;后端为 none 时跳过审查需用户同意。资料对平台、收费、适用范围等未提供更多信息。