用途
codex-review-branch 是一个针对完整功能分支的全自动代码审查技能入口,使用 Codex exec 执行审查。它属于 codex-code-review 的 Branch 变体,是一个轻量入口点,完整工作流、提示词模板和审查逻辑都定义在父技能中,具体参见父技能文件 @skills/codex-code-review/SKILL.md。
主要能力
- 审查范围:完整分支,即自基线以来的全部提交。
- 前置检查:无。
- 提示词模板:@skills/codex-code-review/references/codex-prompt-branch.md。
- 审查者:默认仅 Codex 单独审查。传入 --dual 参数时会增加第二名审查者并行参与(详见父技能 Step 3)。
- 档位:thorough,属于深度变体,P0/P1/P2 会阻断,轮次上限为 30。
使用方式
通过触发关键词调用本技能:branch review、full branch、review branch、codex-review-branch。
可用参数:
- --dual:默认关闭。作用是在并行环境中增加第二名审查者(参见父技能 Step 3)。合并发生在会话中,不写入状态、没有 mode 字段;除非再次传入该参数,下一次调用会恢复为单审查者模式。第二名审查者的意见可以阻断本次审查的门禁。适用于发布、安全敏感变更以及公共 API 面。
文档说明,--dual 是唯一一种会运行两名审查者的代码审查入口。/codex-review-fast 和 /codex-review-doc 在设计上都是单审查者,不提供该参数;因为第二意见的成本只应在变更值得时付出,而本变体正是那种场景。/plan-review --dual 是计划模式下的对应入口,具有相同的可选形态、相同的默认关闭状态,但属于不同的循环。
适用场景
适用于需要对整个功能分支(全部提交)进行深度代码审查的场景,尤其是发布、安全敏感变更和公共 API 面的审查,此时可考虑开启 --dual 获取第二意见。
限制
不适用于以下场景:
- 仅查看 diff 的快速审查(应使用 /codex-review-fast)。
- 带 lint 和 build 的完整审查(应使用 /codex-review)。
- 文档审查(应使用 /codex-review-doc)。
其他具体限制暂未提供。