SuperAPI AI 工具集

review-code

测试与质量

查看项目

更新于 10-15 21:12

技能介绍

用途:review-code 用于沿某一个质量维度审查代码变更并报告发现。它把原先分散的多个质量审查代理合并为一个技能,每个维度的检测内容存放在各自的参考文件中,仅在请求时加载(渐进式披露)。

主要能力:支持多个维度,分为缺陷发现类(change-intent、code-bugs、contracts、type-safety、defect-class)与建议类(operational-readiness、code-design、code-maintainability、code-simplicity、code-testability、test-quality、docs、prose-value、context-file-adherence)。缺陷发现类阈值为“无 LOW 及以上发现”,建议类阈值为“无 MEDIUM 及以上发现”。部分维度为条件性:contracts 适用于变更触及 API 表面或持久数据契约时,type-safety 适用于带类型代码,defect-class 适用于修复缺陷的变更。

使用方式:输入 $ARGUMENTS 携带维度及可选范围,例如 dimension=code-bugs 或 code-bugs src/foo.ts。未给维度时列出可用维度并询问。范围确定:调用方指定文件/路径则只审查这些;否则与基线分支比较,命令为 git diff origin/main...HEAD && git diff,若 origin/main 无法解析则重试 origin/master,两者都无法解析且未给基线时询问基线分支。空或不可审查的 diff 需澄清范围。跳过生成文件、锁文件、第三方依赖和二进制文件。该技能只读,不修改仓库文件,仅可写入 /tmp/ 存放分析产物。

报告格式:包含维度、阈值、状态(PASS/FAIL)、分析文件列表、发现(位置、严重级别、描述、触发条件、影响、建议修复)与汇总。作为清单验收门时以 PASS、FAIL 或 BLOCKED 结束。

限制:每次只加载一个维度的参考文件;缺陷发现类必须写明触发条件,无法写明触发条件的发现不可报告;建议类 Medium 必须写明具体成本。空报告(PASS)是有效结果,不应为填充而编造发现。各维度只报告自己负责的内容,不越界到相邻维度。