SuperAPI AI 工具集

verify-quality

测试与质量

查看项目

更新于 10-15 19:58

技能介绍

用途:verify-quality 用于验证代码质量反模式,包括命名不佳、缺少文档、魔法值和组织结构问题。所有分析均在本地完成。

触发方式:当用户要求“verify agent quality”“verify quality”“check code quality”“review code organization”“check naming conventions”时触发。若需包含安全、模式及语言特定检查的完整验证,应提示用户说“verify agent”。

主要能力:

  1. 发现文件:定位 .py、.ts、.js、.go、*.rs 等源码,重点检查主实现文件而非测试;检查 src/、lib/、app/、项目根目录、agent/、tools/、utils/;排除 node_modules/、.venv/、venv/、pycache/、测试文件、生成文件与迁移。
  2. 质量检查(均为启发式,需人工判断,标记 [H]):命名规范(单字母变量、模糊缩写、大小写不一致、无意义名称、布尔命名缺少 is/has/can);代码组织(文件超 500 行、函数超 50 行、嵌套超 4 层、关注点混合、上帝对象);魔法数字与字符串(硬编码数值、重复字符串、硬编码配置);文档(模块/类/函数 docstring、README、类型提示缺失);错误处理(裸 except、静默失败、泛型异常、无错误处理);代码重复(超过 5 行的相同或近似代码块、复制粘贴函数);注释掉的代码(大段注释代码、过期 TODO、FIXME)。
  3. 生成报告:包含项目、日期、分析文件数、摘要(通过/警告/问题数)、命名、组织、文档、错误处理、发现(通过项与警告项,含位置、影响、建议)、建议。

限制:所有检查均为启发式,需要判断,不能替代完整验证;不包含安全、模式及语言特定检查;未提供安装命令、收费、平台或效果信息。