SuperAPI AI 工具集

superreview

编程与开发

查看项目

更新于 10-16 07:07

技能介绍

Superreview 是一个面向代码审查场景的技能,其核心用途是对变更集或显式指定的项目范围进行系统性审查,覆盖意图、正确性、安全性、复用性和可维护性等维度,并对发现的问题进行独立验证,最终产出一份统一的审查报告。

主要能力与审查流程

该技能使用 references/review-contract.md 中定义的 Codex 原生审查工作流。它只授权审查与报告产物,明确禁止编辑被审查的代码、指令、智能体、技能或配置,包括该技能自身;如需修正,应单独提出建议。

审查按固定顺序进行:先做简化与复用评估,再做正确性与安全性检查,最后做可维护性与清晰度检查。其中简化评估只是一次报告检查,并不代表获得运行会修改代码的简化工作流的权限。在两种深度下,都会依据契约中的意图流程,对比请求的行为与实际交付的行为。

范围与深度

开始工作前需先解析请求的范围。显式路径、排除项、修订版本以及用户的收窄要求优先。默认范围是已暂存、未暂存和未跟踪的变更;若工作树干净,则审查最近两次提交,若不足则回退到一次提交或根提交。QUICK 是默认深度;当请求涉及深度、完整性、合并前或发布审查时,选择 EXTENDED。深度只改变投入程度,绝不改变范围或修改权限。技能会以英文说明具体的范围、深度、基线、检查项和预期报告。

规则与角色

需显式读取适用的 AGENTS.md 指令及其引用的规则;.codex/rules/ 和 paths: 元数据不会自动加载规则。复用项目已有的检查命令和当前运行时可用的原生审查者角色。解析 agent TOML 时应按 TOML 而非 YAML 处理;可用性取决于当前运行时。不要创建智能体,也不要要求 intent-guard 角色。

深度差异

EXTENDED 会增加有边界的领域审查,并对每个候选项进行独立验证;QUICK 则对实质性发现保留具体证据和独立验证,并说明其覆盖范围较窄。

报告输出

技能会在 .codex/reports/<YYYYMMDD-HHMMSS_superreview>/REPORT.md 写入一份去重后的报告,内容包括发现、验证、检查项、意图覆盖情况和局限性。随后用对话语言总结可执行的结果。若缺少检查项或角色、验证不完整,需明确报告;零发现但覆盖不完整并不等于一次干净的审查。

适用场景与限制

适用于需要对代码变更或指定项目范围做结构化审查、并希望获得可追溯报告的场景,尤其是合并前或发布前的审查。限制在于:它不修改任何代码或配置,只产出审查与报告;其深度、范围、检查命令和审查者角色依赖当前运行时与项目已有配置;资料中未提供具体的安装命令、收费方式、支持平台或效果保证等信息。