用途:autoreview 是一个收尾检查用的结构化代码审查助手,用于非平凡代码修改后的提交前/发布前审查,也可审查本地分支或修复后的 PR 分支。它做的是代码审查,不是 Guardian 的 auto_review 审批路由。
主要能力:未指定引擎时默认使用 Codex 审查,默认 gpt-5.6-sol 高推理,仅当账户无法访问 Sol 时回退一次 gpt-5.6-terra;Claude 审查为可选,默认 claude-fable-5。审查前会对新增或修改内容的临时快照运行 TruffleHog,采用低误报的 pre-commit 策略(verified、unknown),二进制缺失时失败并给出官方安装链接,不会自动安装。超大变更包会按节和文件边界切分,单文件过大时按行切分,单次运行最多八段。
使用方式:先设置技能脚本路径,例如 export AUTOREVIEW=".agents/skills/autoreview/scripts/autoreview",然后按目标选择模式:脏工作区用 "$AUTOREVIEW" --mode local;分支/PR 用 "$AUTOREVIEW" --mode branch --base origin/main;单个已提交变更用 "$AUTOREVIEW" --mode commit --commit HEAD。可加 --prompt-file 与 --dataset(须为仓库相对路径),也可用 --parallel-tests "<focused test command>" 并行跑测试。
适用场景:用户要求 Codex/Claude/Pi 审查、二次模型审查,或修复后复查分支。纯内部笔记或 SKILL.md 文档的 diff 不强制审查,但仍应直接检查 diff 并运行仓库轻量文档校验;该例外不覆盖面向用户的文档、可执行示例、配置、脚本、生成文件或行为变更。
限制与约定:审查输出仅为建议,须阅读真实代码路径与相邻文件核实,拒绝不现实的边界情况、推测性风险和过度重构。审查触发修复后需重跑聚焦测试并重跑审查助手。除文档化的 Codex Sol 到 Terra 账户访问回退外,不得切换或覆盖请求的引擎/模型。结构化审查在模型调用活跃时最长可达 30 分钟,心跳行属正常进度,不应因安静 2-5 分钟就终止。不要为审查而推送,仅在用户要求推送/发布/更新 PR 时推送。多审查者面板需显式选择。若 gh/Gitcrawl 报数据库损坏或清单不匹配,先运行 gitcrawl doctor --json。
范围治理:审查是收尾门禁,不是重写任务的许可。首次审查前冻结范围基线;将发现分类为范围内阻塞、后续项或停止升级。当窄 PR 变成架构/协议/迁移/发布流程变更、diff 超过原文件或非测试 LOC 两倍、两轮修复未收敛、最佳修复需先定义规范契约,或修复会使 PR 不再描述同一行为时,应停止修补并报告范围突破。发布分支上只修发布阻塞、发布基础设施失败、精确回移、安装/升级破坏、数据丢失、崩溃或具体安全暴露。
其他事实:面向用户行为时建议与 behavior-validator 搭配,autoreview 是源码感知的,行为验证是源码盲的,干净的 autoreview 不能证明 UI、CLI、API 或生成产物在用户视角下可用。安全视角始终包含,但仅在变更产生具体可操作风险或移除重要安全检查时报告。审查子进程保留引擎认证与无凭据代理变量,剥离进程注入、Git 覆盖和带凭据代理值。回归溯源需区分代码作者、PR 作者、合并者、当前 PR 作者与 PR/日期;若由 clawsweeper[bot] 等自动化合并,尽量识别人类触发者,找不到则说明触发未知。不要在审查内部调用内置 codex review、嵌套审查者或审查者面板。助手以退出码 0 且无被接受/可操作发现即为干净结果,不要为更漂亮的“干净”措辞再跑一次。若拒绝某发现为有意为之,仅在解释真实不变量或所有权决策时加简短行内注释。Windows 下需使用对应的 .ps1 测试脚本路径,--parallel-tests-shell 可选 powershell 或 pwsh。资料未提供具体收费、价格与平台支持范围。