SuperAPI AI 工具集

code-quality

测试与质量

查看项目

更新于 10-15 21:48

技能介绍

用途:在代码修改完成后校验质量,覆盖 SOLID 合规、DRY 重复、linter 错误与架构违规。它属于事后校验,不确认原功能问题是否已解决;应先用验证类技能确认功能修复,再用本技能确认修复是否整洁。官方说明中还提示:若对功能正确性没有把握,同样先跑验证流程再进入本阶段。

主要能力与流程:围绕 canonical workflow(定义在 agents/sniper.md,技能与该 sniper 智能体共用同一套 7 阶段流程,需同步更新)展开,分阶段执行:

  1. 探索(explore-codebase)——阻塞项。收集语言、现有 linter 配置(如 .eslintrc、.prettierrc、pyproject.toml)、包管理器与已安装 linter、项目结构与约定、框架版本、架构模式(Clean、Hexagonal、MVC 等)、状态管理、接口/类型目录位置。
  2. 文档研究(research-expert)——阻塞项。核实库/框架官方 API 文档、当前语法与废弃项、错误模式的最佳实践、版本破坏性变更、安全公告、语言相关的 SOLID 模式。
  3. 影响分析——阻塞项。对每个待改元素用 Grep 查用法并评估风险:0-1 处用法为低风险可直接进行;2-5 处为中等风险谨慎进行;5 处以上或存在破坏性为高风险,须先向用户标记。
  4. DRY 重复检测——非阻塞。使用 jscpd,支持 150+ 语言,示例命令保持原样:npx jscpd ./src --threshold 5 --reporters console,json。重复率阈值分档:<3% 无需处理;3-5% 记录、有余力再改;5-10% 抽取共享逻辑;>10% 强制重构。
  5. 错误检测(linter)与阶段 5 精准修正、阶段 6 验证(重跑 linter、测试与重复检测)。

优先级矩阵:安全类(SQL 注入、XSS、CSRF、鉴权绕过)立即修复;逻辑与高重复率(>10%)同类高优先、本会话内修复;5-10% 重复与性能问题按时间处理;风格问题为低优先级。

限制与禁止行为:不得跳过阶段 1-3 等阻塞项或在阻塞状态继续;不得遗留任何 linter 错误、引入新错误、忽略 SOLID 或 >5% 的 DRY 违规;不得复制粘贴而非抽取共享逻辑;项目原本没有测试时不得新建测试。架构上禁止在组件文件放置接口(零容忍)、在组件中写业务逻辑、单体组件、文件行数超过 FUSE_SOLID_MAX_LINES 未拆分、用本地状态承载全局数据。安全上禁止未获用户批准的高风险变更、静默破坏向后兼容、未经弃用流程修改公共 API。参考文档(重复阈值、linter 命令、SOLID 校验、文件大小规则、架构模式、验证报告模板、完整示例)在同一技能包 references 目录。具体环境要求、安装方式、收费情况与平台支持暂未提供。