SuperAPI AI 工具集

cmd-pr-sweep

测试与质量

查看项目

更新于 10-16 02:37

技能介绍

用途:对已暂存、未暂存或指定分支差异中的近期改动做系统性代码审查,覆盖五个维度,聚焦可操作的问题,忽略吹毛求疵的细节。

主要能力:

  1. 测试缺口:检查新增代码路径是否有对应测试、边界情况(空输入、错误路径、边界值)是否覆盖、现有测试是否仍通过、可测试的工具函数是否缺少单元测试。
  2. 简化:合并或删除条件分支、去除单次使用的多余抽象、把复杂表达式拆为具名变量、剔除无法触发的冗余检查。
  3. 命名一致性:新名称是否遵循代码库既有约定、缩写是否统一、函数名是否准确、相似概念是否命名一致。
  4. 复用机会:重复逻辑是否可改用现有辅助函数、重复三次以上的模式是否应提取、现有工具/常量/类型是否可复用、相似函数是否可合并。
  5. TODO 与注释质量:TODO 是否遵循项目前缀约定、是否说明做什么和为什么、是否残留已解决项、注释是否解释“为什么”而非“是什么”、已知捷径或延后工作是否缺少 TODO。

使用方式:先确定改动范围——未提交改动用 git diff HEAD,分支差异用 git diff main...HEAD,或由用户提供具体文件列表。审查前需完整阅读所有改动文件,理解既有模式而非只看 diff。每条发现需标注文件和行号。

输出格式:按维度输出,格式为“### 维度名”,条目为“- [文件:行] — 发现描述,Suggestion: ...”;若某维度无问题则输出“No issues found.”。最后给出按投入产出比排序的 3 至 5 项最有价值改动。

限制:资料未提供安装命令、平台支持、收费与价格信息,亦未说明具体命令名称,这些事实暂未提供。