用途:用于本地改动、PR 改动或评审循环。先阅读 references/repository.md,再按变更面说明执行。评审通道只报告发现,改动由变更所有者负责修复。
评审预算:接受可选 max-turns=<正整数>,默认 10。首次检查前拒绝缺失、零、负数、非整数或格式错误的值;无上限。每次完整评审计入预算;预算耗尽且未得到 RESULT: PASSED 时,停止并询问是否启动新的明确授权运行,绝不自动延长。
-
选择有效评审范围:评审当前预期改动而非仅 HEAD。从明确目标、PR 元数据或仓库默认值确定 base,含糊时询问;计算 base...HEAD 已提交范围;合并暂存(git diff --cached)、未暂存(git diff)与预期未跟踪文件;每次检查前及每次修复后重新计算并集。未改动代码仅在有效 diff 引发风险时作为证据。保留无关工作区改动。
-
仓库基线:阅读 AGENTS.md、适用的贡献者说明、格式/检查/测试命令、架构与领域文档及变更面约定。仓库规则定义严重级别与必需验证。除非生成器输入、模板或配置变更,跳过生成产物。
-
检查:机械检查逐文件带上下文阅读,检查正确性、安全隐私、数据丢失、授权验证、兼容契约、错误处理、并发、迁移配置与行为测试。结构检查仅在明确要求或仓库要求时运行,关注实质复杂度、所有权、不变量、边界或重复规范辅助函数回归,不因外观、行数或推测性重构阻塞。验证检查针对可运行行为、API 契约、权限、任务事件、迁移、生成客户端或浏览器可见改动,推导具体正常、否定、权限与边界用例。
发现标准:只报告实质、可操作、由 diff 引发的风险。严重级别:Critical 为可能安全隐私泄露、数据损坏丢失、公共契约破坏或主路径中断;Important 为实质正确性、授权、持久化、兼容、覆盖、架构或变更热路径性能风险;Summary 为具体可维护性观察,除非构成实质风险否则不阻塞。每个根因一条发现,锚定最佳变更路径:行,说明具体风险、仓库证据或规则及所需动作。省略赞美、偏好、过时重复评论与推测性清理。
有界评审循环:所有者修复后协调者运行确定性检查,重新计算完整有效范围并请求仅报告发现的新评审。不得凭假设清除发现。存在剩余实质发现、范围扩大或预算耗尽时,停止并请求指示。
输出契约:评审者只返回发现,不编辑、提交、推送或发布。每次检查结束输出 CODE REVIEW、Scope、Depth、Findings、Checks、Residual risk 与 RESULT: PASSED|FAILED。最后非空行必须恰为 RESULT: PASSED 或 RESULT: FAILED。仅当所有实质 diff 风险已分类、无未解决 Critical/Important 发现、所需验证通过或明确受阻且当前有效范围已重新评审时,才通过。