SuperAPI AI 工具集

implementation-final-review

编程与开发

查看项目

更新于 10-16 03:06

技能介绍

用途:在实现完成后、最终验证前审查变更,适用于仓库策略要求独立审查或用户明确要求时。审查范围包括原始需求与完整任务差异,涵盖已提交、已暂存、未暂存及任务自有的未跟踪文件;补丁归属使用目标分支的合并基点,涉及已发布兼容性时另行参考最新发布。发现阈值与支持范围规则见 AGENTS.md。

分级:按语义影响而非行数、扩展名或位置分类,并在现有工作笔记中记录级别与简短理由,不单独创建分类报告。轻量级仅涉及拼写、注释或格式,不改变执行、公共契约、测试预期、配置或文档含义,自检完整差异并运行适用的聚焦检查,独立审查可选。普通级为既有契约内的局部行为变更、常规测试新增或行为文档,需一名全新上下文的独立审查者。高风险包括安全、凭据、敏感数据处理、信任、持久化/恢复、持久状态、并发/取消/共享生命周期归属、已发布兼容性、包/运行时导出、协议归属或跨提供方生命周期,以及任何已验证 P0/P1 的审查周期,需两名互补专长的独立审查者,并阅读 high-risk-review.md。

普通独立审查:先完成受影响测试与格式化等可能改变差异的规范化,JS 测试文件或目录使用 pnpm exec vitest run <path>。向审查者提供原始请求、范围契约、目标/基点/头标识、任务自有路径、完整差异(含新文件内容)、架构参考及聚焦检查命令与结果,并保存已审查内容以便后续比对。以 fork_turns: "none" 启动无继承实现者对话的独立代理,不提供预期发现或修复建议;审查者只读检查完整差异与相关源码,验证范围契约,返回已审查范围、可操作发现与剩余不确定性,仅批准而不检查范围不足。发现需对照支持行为验证并批量修复,变更后重新运行检查并获取独立复审。初始周期最多六次已审查修订,完成交接后的具体反馈开启两次修订周期;升级时携带已消耗修订与未解决根因。

证据保留:将最终内容与记录的已审查内容比对,行为、预期、契约或依赖变化需受影响复审;仅拼写/注释/格式差异可自检后保留原审查。包或变更集变化时运行 $changeset-validation,最终内容运行适用的最终验证门禁,SDK 变更使用 $code-change-verification,文档按文档层级。独立审查者不可用时须明确报告缺失,自审不能满足普通或高风险门禁。高风险工作才阅读 high-risk-review.md,并使用 reviewer-brief.md 及 scripts/review_state.py、scripts/review_protocol.py。