SuperAPI AI 工具集

run-ts-cleanup

通用与其它

查看项目

更新于 10-16 06:16

技能介绍

用途:清理 TypeScript 代码库中的死代码、未使用依赖、AI 生成冗余与弱类型。该技能围绕四大支柱展开:可达性与死代码、封装与边界完整性、类型系统严谨性、模块与构建图健康。它是收尾工具,应在绿色的主分支上运行,而非功能开发中途。

主要能力:使用 Knip 找出未引用文件、死导出、孤儿依赖;用 Biome/Oxlint/ESLint/Ultracite 查找未使用局部变量与死导入;用 tsc 查类型错误与声明发射问题;用 type-coverage 追踪 any 蔓延;用 dpdm/madge 检测循环依赖;anti-slop 检测 LLM 生成的反模式。各引擎互补,一个引擎发现无人导入的文件,另一个发现无人使用的导入。

使用方式:分三种模式,扫掠模式仅执行阶段 0-1 加 lint 自动修复与第一波;标准模式执行阶段 0-3 加五波;深度模式额外做根因分析、类型加固与结构重构。六阶段依次为基线、引擎设置、普查、分诊、根因、成波删除,每阶段设门禁。默认分支为 chore/ts-cleanup,门禁为 tsc --noEmit → 测试 → 构建,配置文件为 knip.jsonc,波次顺序为文件→桶文件→封装→类型→依赖,每波一个提交。

适用场景:功能弃用后、框架迁移后、长时间 LLM 驱动开发之后,或提示清理项目、删除死代码、查找未使用依赖、设置 Knip 时触发。

限制:不用于纯格式化或样式修改;不用于分支、工作树与仓库产物清理(用 run-repo-cleanup);不用于审查 diff 或 PR(用 run-review);工作树不干净或基线不通过时拒绝启动。每个发现删除前须经三问验证,防止误删框架入口、动态导入或公开 API。删除类型前须验证声明发射安全,因为 tsc --noEmit 不构建声明图。不得使用宽泛的顶层 ignore,否则会切断图边导致误报。费用与价格信息暂未提供。