用途:在最终验证前对已完成的实现改动进行独立评审,适用于仓库政策要求独立评审或用户明确请求评审的情况。评审对象包括原始需求与完整任务 diff,含已提交、已暂存、未暂存及任务所属未跟踪文件;补丁归属使用目标分支的 merge base,涉及发布兼容性时另行核对最新发布。按 AGENTS.md 中的问题阈值与支持范围规则执行。
评审分级:按语义影响而非行数、扩展名或位置分类,并在既有工作笔记中记录档位与简短理由,不单独创建分类报告。轻量档仅涉及拼写、注释或格式,不改变执行、公开契约、测试预期、配置或文档含义,自查完整 diff 并运行适用的聚焦检查即可,独立评审可选。常规档为既有契约内的局部行为变更、普通测试新增或行为文档,需一名全新上下文的独立评审者,按下方流程执行。高风险档涉及安全、凭据、敏感数据处理、信任、持久化/恢复、持久状态、并发/取消/共享生命周期归属、发布兼容性、包或运行时导出、协议归属或跨提供方生命周期,以及任一出现已确认 P0/P1 的评审周期,需两名专长互补的独立评审者,并阅读 high-risk-review.md 的严格协议与最终证据规则。
常规独立评审流程:先准备一次,完成受影响测试及可能改变任务 diff 的格式化或安全钩子等价归一化,复用未变更内容的成功聚焦检查,在评审干净前不启动广泛最终验证;向评审者提供原始请求、简短范围契约、目标/基线/头部标识、任务所属路径、含新文件内容的完整 diff、相关架构参考及确切聚焦检查命令与结果,将已评审内容记录为保存的 diff 加新文件快照或内容指纹,临时证据保存在交付物之外,scripts/review_state.py 可用但严格 JSON 包等非必需。评审时启动一名不继承实现者对话的独立代理(支持时 fork_turns: "none"),不提供预期发现、既往结论或修复建议;评审者检查完整 diff 与相关周围源码,核实范围契约而非重跑实现策略,返回已评审范围、具体可执行发现与剩余不确定性,仅给无范围的批准不合格。评审为一次性只读,不编辑、不递归委派、不跑广泛套件;仅允许在既有执行与凭据权限内做聚焦非变异探测。保持任务内容固定,用事件驱动等待,在评审期间处理不影响已评审内容的独立工作。
处理与证据保留:对照支持行为验证发现并作为一批修复,仅当契约或实现形态改变时更新策略;重新运行受影响检查,并在接受完成前就变更内容及其相关边界取得独立评审,范围或横切假设变化时审查完整任务 diff,若变更边界或确认 P0/P1 则升级至高风险流程,常规结论不能替代其必需的两人评审。在既有任务笔记中保留紧凑计数与未解决根因摘要;初始周期最多六次受评审修订,完成交接后的具体反馈开启两次修订周期,这些是上限非目标。升级时把已消耗修订与未解决根因带入高风险交接,记录剩余周期预算并只给严格台账剩余部分,常规结论不获得高风险清洁信用;若无预算,需先取得具体用户决定再派发。未变更内容的基础设施重试不消耗修订;若重复发现同一设计问题,按仓库复杂度重置规则处理。在进度需要决定或预算耗尽时请求具体范围/设计决定,否则自主推进修复、评审、验证与交接。保留证据至完成:对比最终任务内容与记录的已评审内容,行为、预期、契约或依赖改变需相关独立重审,仅拼写/注释/格式的可证明差异可在自查后保留原评审,该豁免不适用于可执行重写、公开注解或行为性文字;提交或暂存相同内容不使评审失效;基线改变需检查上游增量与集成,相关源码或工具变更或影响不确定时重审。对最终内容运行所有适用最终验证门,SDK 改动用 $code-change-verification,文档按文档层级;较轻评审不豁免 SDK 检查。仅在评审与验证适用于交付状态时报告完成,随后按需运行 $pr-draft-summary。若独立评审者不可用,明确报告缺失评审;自评不能满足常规或高风险门。高风险资源:仅高风险工作阅读 high-risk-review.md,使用 reviewer-brief.md 及现有 scripts/review_state.py、scripts/review_protocol.py 辅助,不为轻量或常规改动准备其包、回执或组件清单。