autoreview

用途

Auto Review 用于在收尾阶段运行随技能包提供的结构化审查 helper，由第二个模型对代码改动做一次复核。它明确说明这是代码审查，而非 Guardian 的 auto_review 审批路由。可审查的对象包括：本地未提交改动、Pull Request、分支差异，以及单个提交。

主要能力

目标模式：支持 local（未暂存、已暂存或未跟踪补丁；--mode uncommitted 为其别名）、branch（分支/PR 差异，需指定 --base）、commit（单个提交，如 --commit HEAD）。
任务上下文传递：通过 --prompt 传入从外部来源整理的任务契约，或用 --prompt-file、--dataset 传入仓库相对路径的已有文件。
并行收尾：使用 --parallel-tests 传入聚焦测试命令，可在格式化之后让测试与审查并行运行；并行测试使用临时 home 和净化环境，helper 会在审查前后对源码树做指纹校验。
审查面板：--reviewers 可指定多个审查者（如 codex,claude,cursor）；--panel 为 Codex 加 Claude 的简写。可用 --model、--thinking 按键值形式或内联语法为各审查者指定模型与思考强度。
引擎选择：默认使用 Codex，也可按要求改用 Claude 或 Cursor；cursor-agent 可作为引擎别名单独运行。
输入防护：审查包需经过必需的秘密扫描、敏感路径省略和失败即关闭的输入守卫，不得绕过。超大审查包被拒绝时，应按依赖关系拆分目标，并直接验证跨目标契约。

使用方式

设置技能路径与命令（脚本会依次在 .agents/skills/autoreview、.claude/skills/autoreview、skills/autoreview、$AGENTS_HOME/skills/autoreview 中查找可执行的 scripts/autoreview）：

if test -z "${skill_root:-}"; then
  for candidate in \
    .agents/skills/autoreview \
    .claude/skills/autoreview \
    skills/autoreview \
    "${AGENTS_HOME:-$HOME/.agents}/skills/autoreview"; do
    if test -x "$candidate/scripts/autoreview"; then
      skill_root="$candidate"
      break
    fi
  done
fi
test -x "${skill_root:-}/scripts/autoreview" || {
  printf '%s\n' "autoreview skill not found" >&2
  exit 1
}
export AUTOREVIEW="$skill_root/scripts/autoreview"
export AUTOREVIEW_HARNESS="$skill_root/scripts/test-review-harness"

选择审查目标，例如本地改动：

"$AUTOREVIEW" --mode local

分支/PR 审查并附任务上下文：

task_context='Objective: prevent duplicate payment submission. Acceptance criteria: rapid repeated clicks enqueue one payment. Non-goals: no payment architecture rewrite. Sources: current request; PR description; BILL-123.'
"$AUTOREVIEW" --mode branch --base origin/main --prompt "$task_context"

使用已有提示文件与数据集（须为仓库相对路径）：

"$AUTOREVIEW" --mode branch --base origin/main --prompt-file review-notes.md --dataset evidence.json

使用实际 PR 基分支：

base=$(gh pr view --json baseRefName --jq .baseRefName)
"$AUTOREVIEW" --mode branch --base "origin/$base"

审查单个提交：

"$AUTOREVIEW" --mode commit --commit HEAD

并行测试与审查：

"$AUTOREVIEW" --parallel-tests "<focused test command>"

运行审查面板与指定模型：

"$AUTOREVIEW" --reviewers codex,claude,cursor
"$AUTOREVIEW" --panel
"$AUTOREVIEW" --reviewers codex,claude,cursor --model codex=gpt-5.6-sol --thinking codex=high --model claude=claude-opus-5 --thinking claude=high --model cursor=cursor-grok-4.5-high-fast
"$AUTOREVIEW" --reviewers codex:gpt-5.6-sol:high,claude:claude-opus-5:high

单独的 Cursor Agent：

"$AUTOREVIEW" --mode branch --base origin/main --engine cursor-agent

查看帮助与运行冒烟测试工具：

"$AUTOREVIEW" --help
"$AUTOREVIEW_HARNESS" --fixture benign --engine codex

前置条件与规则

只有在具备权威任务上下文、已完成构建者护栏（builder guardrails）和真实界面证据后，才能开始；需引用证据或报告缺失的前置条件。
调用前需阅读当前用户请求及 PR/MR 标题与描述，跟进并阅读所有被引用的 issue、工单、规格、决策或验收标准来源，优先使用实时来源内容而非分支内的摘要。
整理出简短任务契约：目标、验收标准、明确非目标、来源标识。若指定来源无法访问或权威来源冲突，应停止并报告阻塞，不得静默推断缺失契约。
若不存在外部工单或规格，则以当前用户请求作为任务契约，并说明它是唯一权威来源；不得编造缺失需求。

审查结果的处置

发现项属于建议性质：先核实再修复，保持在任务范围内，不得做出发布决定，也不得触发额外的审查者工作流。需针对代码与任务契约逐条核实发现，拒绝薄弱发现，并检查同类缺陷在相同范围内的其他实例。修复采用满足所有权边界的最小改动；当修复改变代码后，用同一任务契约重跑聚焦测试与 autoreview。当 helper 以退出码 0 结束且没有接受或可执行的发现时停止，并报告该次干净运行。

其他约束

不得为审查而推送；仅当用户要求推送、发布或更新 PR 时才推送。
源码树在审查包创建后发生变化时，应丢弃该结果并针对更新后的源码树重跑。
不得仅凭分块审查断言整体改动干净；应直接验证跨目标契约。
操作边界情况参考 references/troubleshooting.md；在扩大范围、触及发布流程或启动第三轮审查触发的补丁循环前，参考 references/scope.md；模型默认值、推荐模型列表、环境变量覆盖与引擎隔离细节参考 references/engine-details.md；打包来源参考 references/upstream.md。

适用场景与限制

适合在本地提交、分支合并或 PR 交付前，作为第二模型的结构化复核环节，也适合需要多模型交叉审查、或希望测试与审查并行以节省时间的场景。限制方面：审查发现不构成发布批准；必须遵守输入防护与秘密扫描要求；每次目标选择需与改动状态匹配（已推送的工作应使用 commit 或 branch 模式）；缺少权威任务上下文时无法合规开始。价格、收费、运行成本及具体平台要求等信息暂未提供。