SuperAPI AI 工具集

review-code

测试与质量

查看项目

更新于 10-15 21:12

技能介绍

用途:review-code 用于沿单一质量维度审查一次代码变更并报告发现。它把原先分散的多个质量审查 agent 合并为一个技能,每个维度的检测内容放在独立参考文件中,按需加载(渐进式披露)。

主要能力:支持多个维度,分为 defect-finder(change-intent、code-bugs、contracts、type-safety、defect-class)与 advisory(operational-readiness、code-design、code-maintainability、code-simplicity、code-testability、test-quality、docs、prose-value、context-file-adherence)。defect-finder 的 PASS 要求无 LOW 及以上发现;advisory 的 PASS 要求无 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 需澄清范围。跳过生成文件、锁文件、vendored 依赖和二进制文件。读取范围不等于报告范围:可广泛追踪机制,但默认只报告变更引入或暴露的问题。

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

限制:技能为只读,绝不修改仓库文件,仅可写入 /tmp/ 存放分析产物;修复由作者依据报告实施。一次只加载一个维度的参考文件。defect-finder 的发现必须写明触发条件,否则不可报告;advisory 的 Medium 必须写明具体代价。空报告(PASS)是有效结果,不应为填充而编造发现。各维度只报告自己负责的内容,不越界到相邻维度。