SuperAPI AI 工具集

review-gate

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:Review Gate 是 PR 创建前的硬性合规门禁,核心原则是“没有审查证明就不能创建 PR”。它由钩子强制执行,即使尝试跳过该技能,Bash 的 PreToolUse 钩子也会拦截 gh pr create 操作。

主要能力:门禁要求全部满足才允许创建 PR,包括:审查产物已按 <!-- REVIEW:START --> 格式发布到 issue;审查状态为 COMPLETE(非 BLOCKED 或 IN_PROGRESS);未处理发现项为 0;所有推迟发现项都有跟踪 issue 并在产物中关联;若改了安全敏感代码则安全审查完成。

验证流程:先查询 issue 评论确认审查产物存在,再解析最新产物的状态;随后检查未处理发现项数量是否为 0,验证每个 DEFERRED 发现项是否带有编号跟踪 issue,最后在检测到 auth、security、middleware、api、password、token、secret 等模式的文件变更时,要求产物中出现 Security-Sensitive: YES。

审查产物格式:必须严格遵循规定模板,包含 Worker、Issue、Scope、Security-Sensitive、Reviewed 等属性,以及七项标准(Blindspots、Clarity、Maintainability、Security、Performance、Documentation、Style)的结果表、已修复发现项表、带跟踪 issue 的推迟发现项表和汇总,并以 Review Status 结尾。

使用方式:该技能一般在 comprehensive-review、apply-all-findings 以及适用时的 security-review 之后调用,位于 pr-creation 之前。若被拦截,需按要求完成审查、发布产物、修复或创建跟踪 issue,然后重试 PR 创建;安全敏感变更需运行 codex-subagent security-reviewer。

适用场景与限制:适用于要求以审查产物为 PR 前置条件的团队工作流,具体集成方式、hook 配置和运行环境以实际项目为准;当前资料未提供价格、平台支持范围或安装命令等信息。