SuperAPI AI 工具集

codebase-cleanup

测试与质量

查看项目

更新于 10-16 01:38

技能介绍

用途:在用户提出代码库级全面质量扫描时触发,对整个仓库做深入清理。技能会先检测项目语言,并调度 8 个子代理分别审计与清理各自领域。

主要能力(8 个子代理):1 去重,仅在不增加复杂度时应用 DRY;2 类型合并,把重复类型定义合并到共享位置并更新导入;3 死代码删除,用 knip 或同类工具找未用导出、文件与依赖,删除前用 grep 全仓验证;4 循环依赖解决,用 madge --circular 或同类工具识别并重构,不用惰性导入掩盖;5 弱类型消除,把 any、unknown 等替换为具体类型,不靠类型断言压制错误;6 防御性代码裁剪,移除隐藏错误或静默回退的 try/catch,仅保留守护真正不可信输入(用户输入、外部 API、文件系统边界)的部分;7 废弃/遗留代码移除,删除标记 deprecated、恒开特性开关之后或标为 legacy 的死路径,保留一个规范实现;8 AI 冗余清理,去掉桩代码、占位代码、进行中注释与过度注释,仅在确有必要时保留上下文。

执行前准备:从 package.json、Cargo.toml、pyproject.toml、go.mod 等配置文件检测语言;确认测试运行器并验证测试通过,若测试本就失败则中止;创建分支 cleanup/<YYYY-MM-DD>;排除生成文件、node_modules、dist、vendor、锁文件及 .gitignore 中的路径。

执行顺序:分两阶段。阶段 1 并行运行 1、2、5、6、7、8;阶段 2 在阶段 1 提交后并行运行 3、4。死代码删除(3)在去重(1)与类型合并(2)之后,避免删掉即将被复用的代码;循环依赖(4)受益于先做类型合并。

约束:每个子代理独立提交,提交信息为 cleanup(<task>): <summary>;每次提交后运行测试套件,失败则回滚该提交并把失败写入最终报告,不自动修复;多个子代理触及同一文件须串行,后运行者基于先前提交 rebase;不得跳过钩子(--no-verify)或强制推送。

报告:全部完成后生成一份汇总,包含每个子代理更改的文件数、增删行数与关键发现;失败或被回滚的子代理及其失败测试输出;被标记但未自动修复的低置信度问题,供人工复核。

限制:技能面向 Claude 插件环境使用;具体触发词、安装方式与收费信息资料未提供。