用途:Auto Review 作为收尾检查运行内置的结构化审查助手,属于代码审查,而非 Guardian 的 auto_review 审批路由。适用于用户要求 Codex/Claude/Pi 审查或二次模型审查时,或在非平凡代码编辑后、最终提交/发布前,以及修复后审查本地分支或 PR 分支时使用。对于整个 diff 仅为纯文本内部笔记或 SKILL.md 文档的改动不需要强制审查,但仍应直接检查 diff 并运行仓库的轻量文档校验;该例外不覆盖面向用户的文档、可执行示例、配置、脚本、生成文件和行为变更。
主要能力:未指定引擎时默认用 Codex 审查,默认以 gpt-5.6-sol 高推理运行,仅当账户无法访问 Sol 时用 gpt-5.6-terra 重试一次;Claude 审查为可选项,默认使用 claude-fable-5。需要验证用户可见行为时,应将 autoreview 与 behavior-validator 配对:autoreview 是源感知的,判断改动包;行为验证是源盲的,依据行为契约判断运行中的产品或工具。干净的 autoreview 并不证明 UI、CLI、API 或生成产物从用户视角可用。调用引擎前,autoreview 会对被审查新增或修改内容的临时快照运行 TruffleHog,采用与预提交策略匹配的 verified、unknown 规则;二进制不可用时以官方安装说明链接报错,绝不自动安装。
使用方式:一次性设置技能脚本路径,使用 $AUTOREVIEW 与 $AUTOREVIEW_HARNESS。例如本地脏改动:"$AUTOREVIEW" --mode local;分支/PR:"$AUTOREVIEW" --mode branch --base origin/main;已提交单次改动:"$AUTOREVIEW" --mode commit --commit HEAD。可提供仓库相对路径的审查上下文,如 --prompt-file review-notes.md --dataset evidence.json。并行收尾可先格式化,再使用 "$AUTOREVIEW" --parallel-tests "<focused test command>";Windows 下可用 --parallel-tests-shell powershell 或 pwsh。
限制与注意事项:审查输出仅为建议,绝不盲目套用,需阅读真实代码路径与相邻文件逐一验证;拒绝不现实的边界情况、推测性风险、大范围重写和过度复杂化修复。优先在正确归属边界做小修复,不轻易重构。不要从审查内部调用内置 codex review、嵌套审查器或审查小组。辅助程序以 0 退出且无被接受/可操作的发现时即视为干净结果,无需为更漂亮的结论再跑一次。多审查者面板仅在显式要求或风险需要额外成本时选用。不要仅为审查而推送。若 gh/Gitcrawl 报告 database disk image is malformed,可运行 gitcrawl doctor --json 一次修复缓存后重试。
范围治理:autoreview 是收尾门禁,不是重写任务的许可。首次审查前冻结范围基线。发现分为范围内阻塞项、后续跟进项和停止升级项。当窄 PR 变成架构/协议/迁移/发布流程变更,diff 超过原文件数或非测试 LOC 两倍,或两轮修复未收敛时,应停止打补丁并报告范围断裂。发布、beta、稳定、热修、签名、公证、appcast、包发布等工作中应使用冻结纪律,只修发布阻塞项。
大包处理:辅助程序会先扫描完整补丁再分区,适合聚合提示限制的安全包为一次整合审查;更大包按区段和文件边界切分,单文件过大时按行边界切分并保留文件/区块上下文和绝对行偏移。单次运行上限为八个有界批次。分块便于大 diff 审查,但无法让一次模型调用获得全部跨文件实现细节,架构密集型改动仍宜保持可在一个批次内理解的分支或 PR 形态。审查输出为建议性质,需人工核验后决定是否采纳。具体安装步骤、完整命令参数与配置项请参见原始资料,本文未逐条展开。