SuperAPI AI 工具集

codex-review

测试与质量

查看项目

更新于 10-15 20:06

技能介绍

用途:当用户提出代码审核、代码审查、review、检查代码等请求时,触发该技能,对未提交改动或最新提交执行 Codex 审查。核心思路是把“代码改动 + 意图描述”一起交给 AI,先记录意图再审查,以提高审查质量。

主要能力:分两阶段运行——准备阶段检查工作目录、更新 CHANGELOG;审查阶段在隔离上下文中调用 Task 执行 Lint 与 codex review。若 CHANGELOG 未更新,会自动分析 git diff 并生成条目写入 [Unreleased];审查前会把未跟踪的新文件加入暂存区,避免 codex 报 P1 错误。

使用方式:先运行 git diff --name-only && git status --short 判断模式。有未提交改动走常规流程;工作目录干净则用 codex review --commit HEAD。按改动规模判定难度:文件数≥30 或总改动≥2000 行为 Critical;文件数≥10、总改动≥500 行、或单侧≥300 行为 Difficult;其余为 Normal。通过 node <skill-dir>/scripts/select-review-model.mjs --difficulty <normal|difficult|critical> 获取推荐 model、effort 与 timeoutMs,再用 Task 执行 lint 与 codex review。Lint 命令按项目类型:Go 用 go fmt ./... && go vet ./...,Node 用 npm run lint:fix,Python 用 black . && ruff check --fix .。

限制与注意:codex review 不接受 --full-auto、-s/--sandbox 或 --dangerously-* 等标志,不要添加。仅在明确的模型或推理强度不可用失败时才按 fallback 链重试,且每个候选使用自己的 timeoutMs;lint 只运行一次。审查发现 P0/P1/P2 问题需主动修复并重跑验证,直到不再出现;P3 及以下可仅报告。修复应保持最小范围,不扩展到无关重构。脚本不可用时回退到内置默认模型配置。具体模型名称、价格与耗时数据来自资料,实际可用性以运行结果为准。