SuperAPI AI 工具集

autoreview

编程与开发

查看项目

更新于 10-16 06:39

技能介绍

Auto Review 是一个用于预提交/发布前代码审查的技能,运行捆绑的结构化审查助手作为收尾检查。它是代码审查,不是 Guardian 的 auto_review 审批路由。

用途

当用户要求 Codex 审查、Claude 审查、Pi 审查、autoreview 或第二模型审查时使用;在非平凡代码编辑之后、最终提交或发布之前使用;在修复后审查本地分支或 PR 分支时使用。对于整个 diff 仅为纯文本内部笔记或 SKILL.md 文档的变更,不要求 autoreview,但仍应直接检查 diff 并运行仓库的轻量文档验证(如有)。该例外不覆盖面向用户的文档、可执行示例、配置、脚本、生成文件或行为变更。

主要能力

默认引擎为 Codex 审查,使用 gpt-5.6-sol 与高推理;仅当账户无法访问 Sol 时重试一次 gpt-5.6-terra。Claude 审查为可选,默认使用 claude-fable-5。审查输出仅作建议,绝不盲目应用;需通过阅读真实代码路径和相邻文件核实每条发现,必要时阅读依赖文档/源码/类型。拒绝不切实际的边界情况、推测性风险、大范围重写和过度复杂化代码库的修复。优先在正确的所有权边界做小修复,除非能明显改善缺陷类别,否则不重构。当接受的发现显示某类缺陷或重复模式时,在修复前检查当前 PR 范围内是否有同类实例。

使用方式

先设置技能脚本路径,然后使用 $AUTOREVIEW 和 $AUTOREVIEW_HARNESS。可选项目本地技能、Claude Code 项目本地技能、源码检出或全局技能路径,Windows 使用对应的 PowerShell 路径。选择目标:脏本地工作使用 --mode local(--mode uncommitted 为别名);分支/PR 工作使用 --mode branch --base origin/main;已提交的单个变更使用 --mode commit --commit HEAD。可选审查上下文通过 --prompt-file 和 --dataset 传入,且必须为仓库相对路径。若存在打开的 PR,使用其实际 base。

大变更包

助手在分区前扫描完整补丁。适合聚合提示限制的安全包保持一次集成审查;更大的包在包区段和文件边界处拆分,超大单文件块按行边界拆分并重复文件/块上下文与绝对行偏移。每个原始包字节在通过序列中恰好出现一次,所有验证报告在必需发现和退出状态检查前合并。一次运行最多八个有界通过。

并行收尾

若格式化会改变行位置,先格式化。然后可并行运行测试与审查:--parallel-tests "<focused test command>"。Windows 上默认 shell 保留平台 cmd.exe 语义,可用 --parallel-tests-shell powershell 或 pwsh。并行测试仅继承少量普通 OS、CI 和工具链变量白名单。

适用场景

非平凡代码编辑后的收尾检查、提交或发布前审查、修复后审查本地分支或 PR 分支、需要第二模型意见时。

限制

审查结果仅作建议,需人工核实。结构化审查在模型调用活跃时可能长达 30 分钟,心跳行如 review still running: ... elapsed=... pid=... 表示健康进展而非挂起。不要在安静 2-5 分钟或仍在 30 分钟窗口内就终止审查。TruffleHog 需按官方平台中立说明安装,autoreview 在二进制不可用时失败并给出链接,绝不自动安装。审查包仍会省略安全敏感路径或文件。分块使大 diff 审查可用,但无法让单次模型调用获得所有跨文件实现细节。范围治理:autoreview 是收尾门,不是重写任务的许可;需冻结范围基线,将发现分类为范围内阻塞、后续跟进或停止升级;当窄 PR 变成架构变更、diff 超过原始文件或非测试 LOC 的 2 倍、两个审查触发补丁周期未收敛等情况时停止修补并报告范围破坏。发布分支需遵循冻结纪律,仅修复发布阻塞、失败发布基础设施、精确回移、安装/升级破坏、数据丢失、崩溃或具体安全暴露。