run-codex-review 是一个已弃用的兼容性垫片(compatibility shim),对应旧的 /codex:review 安装路径。它不再自带实现,而是把请求路由到拥有用户真实意图的规范技能。资料明确要求:不要恢复旧的 runner,也不要发明新的 runner;先选定路由,再加载目标技能。
用途
该技能用于识别用户意图并转发到正确的规范技能。触发场景包括:对一组分支运行 codex 审查、用 codex 收敛分支、对分支列表做修复循环;恢复中断的 codex 审查运行、救援审查任务;在打算随后使用 codex 审查时开启 PR 或移交审查;处理多个机器人(Copilot、CodeRabbit、Devin)对 PR 的审查反馈;回看 codex 审查反馈并判断该处理哪些;以及安装了 run-codex-review 但斜杠命令无反应的旧安装路径用户。典型信号是:分支列表(逗号分隔、branches.txt 或 ≥2 个 git ref)加上 review、ship、merge、close out 等关键词,且 codex --version 成功。
不适用场景
当用户想审查他人的 GitHub PR 是否可合并时,应加载 review-pr;当用户想要通用的非 codex 并行编码扇出时,应直接加载 run-codex-2 的 exec 模式;当工作只是开启 PR 且不涉及 codex 审查时,应加载 review-self;当仓库在多个 worktree 中处于脏状态且没有立即审查意图时,应加载 run-repo-cleanup。
路由表
按用户意图匹配一行,说明路由,然后把控制权交给指定技能,垫片任务即结束。
- 按分支的 codex 审查修复循环(分支列表 + 审查关键词)→ run-codex-2 review 模式,入口:node skills/run-codex-2/skills/run-codex-2/scripts/run-codex-2.mjs review --branches <list>
- 恢复/救援中断的 codex 审查运行 → run-codex-2 rescue 模式,入口:node skills/run-codex-2/skills/run-codex-2/scripts/run-codex-2.mjs rescue --manifest <path>
- 为作者自己的分支开启 PR(含自审正文)→ review-self,加载 skills/review-self/skills/review-self/SKILL.md
- 分诊来自一个或多个审查者(人类、Copilot、CodeRabbit、Devin、Bito)的反馈 → review-feedback,加载 skills/review-feedback/skills/review-feedback/SKILL.md
- 审查者侧对 PR 或 diff 做合并风险审查 → review-pr,加载 skills/review-pr/skills/review-pr/SKILL.md
- 审查任务后 worktree 与分支变脏 → run-repo-cleanup,加载 skills/run-repo-cleanup/skills/run-repo-cleanup/SKILL.md
消歧规则
codex 审查不等于 PR 审查。run-codex-2 review 模式对每个分支运行 codex exec review --base <base>,并通过分类器轮次收敛,它不开启 PR;PR 创建属于 review-self,审查者侧合并判断属于 review-pr。分支列表信号优先用于修复循环:若用户提供 ≥2 个分支并提到 review/ship/merge/close out,即使也提到 PR,仍路由到 run-codex-2 review,PR 移交是收敛后的独立下游步骤。多机器人评估不等于 codex 收敛:当用户点名第三方审查者或说“机器人审查了我的 PR”,属于反馈分诊,路由到 review-feedback。manifest 存在则强制救援:若状态目录下存在带非终态条目的 manifest.json,且用户说 resume/continue/pick up/rescue/prior run,则路由到 run-codex-2 rescue,不要覆盖活跃 manifest。
边界与反模式
该垫片不生成 codex、不写 manifest、不启用 Monitor,路由就是全部工作,运行时由规范技能拥有。它不拥有任何斜杠命令;内置的 /codex:review 位于 run-codex-2 的 scripts/codex-cc/ 下,review 模式不使用它,review 模式使用原生 codex exec review。不要恢复旧的 run-codex-review runner,旧的第三方机器人等待时序常量已退役,机器人等待路由到 review-feedback。不要绕过路由表“省一步”,错误路由会丢失用户的 manifest、分支列表或反馈上下文。不要把“codex 收敛分支”和“PR 可供审查”合并为一次技能调用,它们是两条路由(run-codex-2 review → review-self)。不要发明 /codex:resc 之类的斜杠命令,救援是 run-codex-2 的 CLI 子命令。
触发精度提示
当路由到 run-codex-2(review 或 rescue 模式)时,移交前确认环境信号,以免规范技能退回请求:codex --version 退出码为 0(技能假定 0.130.0+ 以支持 codex exec review 标志);git rev-parse --is-inside-work-tree 在当前目录成功;分支列表可解析(逗号列表、branches.txt 或位置参数),review 模式至少 2 个 ref;codex login status 是软探测,即使状态显示“Not logged in”,也允许 bearer-token/托管 companion/代理认证(设置 USE_CODEX_SKIP_CODEX_AUTH=1 可绕过 bash 引导硬失败);救援场景需在解析出的状态目录下存在 manifest 路径,且 review 任务救援要求 manifest.mode == "review"。任一信号失败时,用一行说明缺口并停止,不要自动即兴进入 run-codex-2 让其在下游失败。
最终行为
从路由表选一行,用一行说明所选路由,并加载规范技能的 SKILL.md。垫片本身不产生其他产物——没有 manifest、没有 Monitor、没有 codex 生成、没有 PR,所有下游契约由规范技能拥有。