用途 本技能用于对代码变更进行独立的、只读的对抗式代码审查。它只负责审查方法与问题结论;修复和重复审查循环由调用方(父流程)负责。被作为子代理调用时,它保持只读并向父流程返回结论,不反向委派,也不启动修复循环。若直接请求中同时包含实现工作,实现部分应交给编码工作流,审查部分再以只读任务交给本技能。
只读约定 审查者检查代码、diff、上下文和已有证据;不在被审查的检出目录中执行可能修改它的项目代码或测试。可使用提供的验证证据、只读分析,或在明确授权且无发布凭据的条件下执行隔离检查;仍未验证的检查需如实报告。审查输出放在对话中或明确要求的外部报告产物中,不向仓库主动添加跟踪文件。不猜测缺失的需求、行为或事实;能安全等待的问题记为待定项及受影响决策;若阻碍当前正确性判断,则标记该范围不完整并主动询问用户(子代理场景下把具体问题返回父流程)。未回答的问题或不可用的验证不能当作通过。
工作流程
- 预检(必需):PR URL 需获取平台 diff 与元数据(base/head、描述、评论、CI 状态),并确认本地审查头与该 PR 对应。确定审查范围并冻结 baseline_commit:分支/PR 审查取基线分支与初始审查头的 merge-base;未提交变更审查取初始 HEAD;记录用户指定的路径限制。并行收集分支状态、基线以来提交、已跟踪变更(含提交、暂存、未暂存)、暂存层差异、新文件,并探查相关模块、用法、契约、入口、所有权边界与关键路径。
- 风险优先审计(必需):覆盖范围内全部变更,按相关性在 A–F 类中取舍深度与顺序,不适用类别直接标注,不虚构问题。A 行为回归与兼容性(分支逻辑、默认值、开关、输入输出契约、API 兼容、命名与返回值语义漂移);B SOLID 与架构(SRP/OCP/LSP/ISP/DIP、过宽类型掩盖领域约束,倾向增量重构);C 安全与可靠性(未授权可达、租户数据泄漏、并发竞态、部分失败的一致性、依赖固定与 CVE、禁用 TLS 校验等,兼顾可利用性与影响);D 性能与稳定性(10×/100× 数据、N+1、热路径开销、失败可调试性、日志泄密、空值/0/空处理);E 可删除项(无用、冗余、关闭特性代码,区分可立即安全删除与延后计划);F 测试覆盖与语言特定检查(变更的可观察契约是否有足够区分性验证;仅在逻辑实质未验证且无法用更小检查覆盖时计为回归风险;缺陷修复仅在现有测试无法捕获原失败时建议聚焦回归测试;跨模块契约未验证时才要求集成覆盖;断言需能区分真实行为与绕过/空操作)。语言特定检查包括:Python 的 naive/aware datetime 混用、ORM 分离实例懒加载、ORM 方言可移植性;TS/React 的 useEffect/useMemo/useCallback 依赖问题;JS/Node 无防护的全局补丁/垫片。
- 呈现结论与覆盖:按输出模板给出严重级别与证据规则,返回已验证的文件/行位置、失败场景、代码或契约证据、影响与修正建议,并区分已验证失败、未验证风险与可选建议;风格偏好或无依据的假设不能成为阻断性问题。对每个修改区域主动尝试用现实失败场景反驳其正确性;后续轮次重读全部累积变更(含提交、暂存、未暂存与新文件),不缩窄到最近修复。返回审查快照标识、基线、覆盖路径与暂存状态、问题及覆盖/验证缺口;部分审查或前置不可用不得报告为干净完整审查。无剩余可操作问题时明确说明已查范围与残留限制。
- 报告自检:按输出模板自检并返回只读结果,不编辑、暂存、提交、推送、更新远程元数据、回复、解决讨论串、触发审查或实施建议修复。
限制与反模式 不得忽略默认值修改带来的隐式行为变化;不得把未验证项标为通过;不得为让测试通过而绕过关键检查(移除鉴权、吞异常、降低安全);不得把审查调用视为修复或发布授权;不得把部分审查呈现为干净审查。避免在安全与正确性之前罗列风格/命名问题、未列检查项就说“未发现问题”、只贴代码不说明问题、所有问题同级对待、靠猜测而非阅读代码与 diff 判断行为。
资源 按需加载:solid-checklist.md(B 类需气味提示或重构启发)、security-checklist.md(C 类需威胁模型细节)、code-quality-checklist.md(D 类需稳定性/性能子检查)、removal-plan.md(E 类发现可删除项)、output-template.md(第 3–4 步问题结构、证据规则与报告自检)。