用途:Review Gate 是智能体生成改动的最后一道安全关卡,在提交、推送、创建或更新 PR、合并、落地,或把生成的补丁应用到用户文件之前运行。只读审查、规划、问题分类和本地探索不需要此关卡,除非下一步会落地或发布改动。
主要能力:检查 diff、收集验证证据、起草 Review Pack;在提交、推送、创建 PR、合并、删除分支或应用未获明确批准的补丁前升级确认;当验证过期、敏感面缺少审查或批准含糊时,基于证据阻止落地;把重复出现的审查发现转化为新的检查项、验证命令或 Review Pack 风险提示。
使用方式:产出紧凑的 Review Pack,包含 intent、diff_summary、files_changed、driving_skill_or_issue、risks、missing_tests_or_verification、commands_run、evidence、open_questions、approval_needed_for、decision,并按严重程度排序,附精确文件路径、PR 号、issue 号、命令名和当前 head SHA。Gate 状态包括 draft_pack、needs_fixes、awaiting_human、approved、approved_with_fixes。智能体不得自我批准;此前的 CI 成功、审查通道或本地测试通过只是证据,不是批准。
适用场景:智能体生成 diff 的落地检查点;flowguard 应在落地检查点调用此关卡;队列技能可用审查通道获取独立发现,但 Review Gate 仍记录面向人的 pack 和批准状态。GitHub PR 可结合 PR head SHA、check rollup、merge state、GraphQL reviewThreads、关联 issue 意图。
限制:批准是动作特定的,“提交它”不等于“合并它”;审查通道是独立证据而非人工批准;若修复在批准后改变了 diff,需刷新验证并更新 pack 再落地。验证过期、缺失或绑定到不同 head SHA 时设为 needs_fixes;diff 涉及 auth、payments、secrets、permissions、innerHTML、eval、shell execution、generated registry、hooks 或高上下文文件时须明确指出;批准含糊时设为 awaiting_human 并只请求指定动作。Spellbook 改动通常引用 git diff --check、python3 ./scripts/validate_skills.py --check、python3 ./scripts/audit_skill_quality.py skill-name;代码改动使用项目特定测试。命令无法运行时报告前置条件,并保持决定不进入 approved。