用途:对 PR、分支、未提交改动或自某版本以来的工作进行代码审查。按请求选择模式,区分“能否发布”与“是否做对了事”。
主要能力与模式:closeout(默认)用于提交/发版前把关、autoreview、第二意见,优先 P0/P1 阻塞项,由共享策略选一名审查者;axes 用于对比 Standards 与 Spec,产出两份独立报告,尽可能由运行时原生子代理执行;full 用于大型 PR、多面、安全关键或 /workflows-review,走多智能体 P1–P3。full 不在此重实现,而是加载 skill: workflows-review,并传递相同目标与参数;该技能负责智能体发现、技能切片、利益相关者/场景检查与 todo/prd 输出,同时仍须遵守 closeout 的范围治理与单一主审查者规则。与 workflows-review 的区别:本技能是聚焦关卡或双轴检查,使用 0–2 名审查者,成本低可频繁运行;后者是穷尽式多智能体审计,成本高,属 workflows-* 流水线的一部分。
使用方式:模式选择按请求顺序判定——出现 full/exhaustive//workflows-review 选 full;axes/standards/spec/review since <ref> 选 axes;closeout/autoreview/ready to ship/before commit 选 closeout;空请求或“review this”且工作区脏或有打开的 PR 选 closeout;含糊的大型多包 PR 只问一次选哪种。可选标志:--max-priority P0|P1|P2|P3(closeout 严重级别上限,默认 P1)、--base <ref>(分支基线,默认 origin/main 或 PR 基线)、--second-opinion(主关卡后再跑可用的独立审查者)。调用示例:/code-review、review before I ship、review since main、code-review axes、code-review full、codex review --uncommitted。
限制与规则:审查请求保持只读;仅在同时授权修复时,才让实现者修改已验证且在范围内的发现。不要通过 push 来创建审查目标。空 diff 应报告“nothing to review”并停止。重要修复后须重跑同一模式,直到干净或范围迫使停止。仅散文式内部文档可略读,跳过重度关卡。模型遵循共享 AGENTS.md 的角色与单一主审查者规则,默认用当前运行时原生审查者;只有用户要求第二意见或共享策略要求且该模型可通过其正常工具链获得时才换模型;未显式选择并证明前,不得称审查为独立或特定模型。运行时能力名称见 ../RUNTIME_TOOLS.md。