SuperAPI AI 工具集

legacy-testing

测试与质量

查看项目

更新于 11-02 16:14

技能介绍

遗留代码通常指没有测试的代码。该技能的核心目标是在任何重构之前,先为承载业务的行为建立安全网:先评估、再提议、等待批准,然后执行。

主要能力包括:评估目标文件或文件夹的测试覆盖现状与未测试区域;识别外部输入可达的入口点(HTTP 路由、CLI 命令、消息处理器、解析器、导出函数等);根据评估结果从菜单中选用可测试性改造、特征测试、审批测试、崩溃搜寻属性测试、不变量属性测试、度量与重构等步骤;度量覆盖率与变异分数;最后按计划执行重构。

使用方式:从仓库根目录运行 scripts/assess.sh [path] 进行评估;按模板写出计划,逐项说明目标与理由;向用户展示计划并等待一次批准;批准后按顺序执行各步骤,中途不逐步询问;仅在需要标记等价变异体、变更计划外的 CI/配置或修复疑似缺陷时暂停询问;最后统一报告前后分数、新增测试、疑似缺陷、重构变更和待决事项,并删除所有临时文件。

适用场景:代码库或模块几乎或完全没有测试、需要安全修改;需要先弄清现有行为再做改动;需要对入口点做崩溃搜寻与不变量属性测试;需要以变异分数衡量测试有效性。

限制与注意:特征测试会固定当前行为(包括缺陷),疑似缺陷应记录并在后续单独修复;审批测试属于临时脚手架,需标记并在功能测试覆盖后删除;不稳定的测试需要隔离并报告;变异分数应聚焦承载业务区域而非整个仓库;重构默认作为计划最后一步,仅在用户明确要求时省略。最近验证记录为 2026-10-04 在 Claude Code 2.1.289 上仅做计划验证,未执行完整流程;此前在 TicketBay src/db/admin-queries.ts 上变异分数从 62.7% 提升至 98.5%,并固定了四个疑似缺陷。