用途:当用户要求“find bugs”“review changes”“security review”“audit code”或在合并前检查分支问题时使用,也可附带审查重点参数(如聚焦 auth 变更)。仅在被明确请求时审查,不主动触发。
主要能力:读取相对默认分支的完整 diff,逐行审阅每个改动文件;梳理攻击面(用户输入、数据库查询、鉴权检查、外部调用等);按安全清单检查注入、XSS、认证与授权、会话与 CSRF、竞态条件、密码学与密钥、信息泄露、拒绝服务、业务逻辑;同时检查逻辑缺陷(如 off-by-one、空值访问、异步错误、资源泄漏、错误吞没、边界条件);验证每个发现是否为真(是否有中间件、框架保护或既有测试覆盖),按严重级别分类并给出证据与修复建议。
使用方式:先用命令获取默认分支与 diff,例如 gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name',然后 git diff <default-branch>...HEAD、git diff --name-only <default-branch>...HEAD;diff 过大时逐文件读取,并可对比基线 git show <default-branch>:<file-path>。流程包括收集 diff、映射攻击面、执行安全清单、查找逻辑错误、逐项验证、分级排序、预结论审计、输出报告、复核与质量自评(要求达到 8/10)。
适用场景:合并前的分支审查、近期改动的安全审查、带审查指导的代码检查。
限制:只审查分支 diff,不覆盖未改动代码或整个代码库;只报告不做代码修改;不报告风格或格式问题;不运行 SAST/DAST 等自动化安全工具;分支与默认分支一致时无可审查内容;无法确认的发现应降级或删除,不得编造问题;报告中不得包含任何真实密钥值,只描述类型与位置。