SuperAPI AI 工具集

code-review

测试与质量

查看项目

更新于 10-16 05:43

技能介绍

用途:对当前分支相对基准分支的合并结果做智能体式代码审查,逐行检查改动并生成一份结构化 Markdown 审查报告,默认输出为项目根目录的 REVIEW.md,用户可指定其他文件名或要求输出到屏幕(STDOUT)。

用法:在 git 仓库中运行 node <skill-dir>/scripts/review.mjs prep [--base <ref>] [--exclude <pattern>]... 准备差异。默认基准为本地 main,其次本地 master;prep 只使用本地引用、不执行 fetch,会创建基于虚拟合并的 diffFile 与 sourceDir,且不写入 HEAD、真实索引或工作区文件。退出码:0 就绪、1 其他失败、2 存在已暂存或未暂存改动、3 合并冲突、4 基准缺失或无效、5 Git 版本低于 2.38。若改动达 1,000 行及以上,运行 node <skill-dir>/scripts/review.mjs split --run-dir <runDir> [--target <lines>] 拆分并委派,随后按清单分批处理,最后由父代理汇总并写入报告。审查完成后运行 node <skill-dir>/scripts/review.mjs clean --run-dir <runDir>,若 runDir 丢失可运行 clean --all。

主要能力:检查 bugs、安全问题、DRY 违规与可简化点,优先标记高严重度问题;核对调用点、陈旧代码、数据流与错误处理;按优先级输出带严重度标记(🔴🟡⚪)的问题清单与代码建议。

限制:审查期间不修改源文件,子代理不得写文件;工作区存在已暂存或未暂存改动时会阻断;不支持过旧 Git 版本;报告格式与严重度规则按资料所述执行。