SuperAPI AI 工具集

remove-deadcode

编程与开发

查看项目

更新于 10-16 11:51

技能介绍

用途

该技能用于删除可证明无引用的代码,同时避免破坏现有功能。它强调一个简单规则:先证明代码已死,再删除它。看似未被使用的符号,往往通过 barrel 导出(index 文件)、测试、反射或框架入口点被间接引用,因此删除前必须验证。若目标是保留行为不变、仅降低复杂度(不删除代码),则应使用 simplify 技能。

主要能力

技能按四个阶段组织删除流程:

  • 第一阶段:并行扫描。同时运行多种独立检测器收集候选项,包括编译器 / linter 的未使用标志(如 TypeScript 的 tsc --noUnusedLocals --noUnusedParameters、ESLint 的 no-unused-vars、Go 的 deadcode/staticcheck、Python 的 vulture、Rust 的 cargo +nightly udeps / dead-code 警告);孤儿文件(未被任何文件导入的源文件);未使用的导出(从未在其它地方被导入的导出符号);LSP 引用(「查找所有引用」仅返回定义本身)。当代码库较大时,可将广泛的搜索并行委派给 explore 子代理,每次搜索聚焦于一个问题。

  • 第二阶段:逐个验证候选项。对每个候选项确认其确实已死。若出现以下任一情况,则应放弃删除(保留代码):通过外部代码导入的 barrel/index 文件被重新导出;被测试、fixture 或快照引用;属于框架/工具的入口点(路由处理、CLI 命令、迁移、插件钩子、main、序列化器),按约定而非 import 被发现;通过反射、动态导入、字符串键或 DI 容器到达;属于已发布的公共 API(@public、导出的包表面)。在每次编辑前立即重新运行「查找引用」(LSP),因为随着先前项目被删除,引用图可能已发生变化。

  • 第三阶段:无冲突地批量删除。将删除项按文件分组:同一文件中的所有内容放入同一批次,使并行编辑不会冲突。删除符号/文件及其现已无用的导入。精确暂存:使用 git add <specific files>,绝不用 git add -A。

  • 第四阶段:证明删除安全。每批次后,构建/类型检查项目;运行测试套件(或受影响子集);重新运行未使用符号检测器,计数应下降而非增长。若构建或测试失败,回退该批次,并针对出问题的项重新执行第二阶段验证。

使用方式

按上述四个阶段执行:先并行扫描收集候选,再逐个验证,然后按文件分批删除并精确暂存,最后通过构建、测试和重新检测证明安全。技能还给出报告要求:列出被删除的内容及证明其为死代码的证据,格式如 removed <file/symbol> — <how it was proven unused: no importers / LSP 0 refs / linter>,并在末尾附上构建与测试结果,以便调用者信任该改动。

适用场景

适用于需要清理代码库、移除确实无引用代码的任务,尤其是任务描述涉及「删除死代码」「查找未使用代码」等情形。也可用于重构过程中安全瘦身。

限制与反模式

技能明确列出反模式:未经引用检查仅凭直觉删除;因为「看起来没用」就批量删除整个目录;使用 git add -A 混入无关改动;删除只能从测试到达的内容,然后连同测试一起删除以使其看起来未被使用——这会掩盖回归。

暂未提供

关于该技能的安装命令、具体配置、收费或价格、支持的平台、实际效果数据,资料中暂未提供。