SuperAPI AI 工具集

remove-deadcode

编程与开发

查看项目

更新于 10-16 08:20

技能介绍

remove-deadcode 是一个死代码清理技能,定位为“编排者(ORCHESTRATOR)”工作流:由主流程负责扫描、验证、分批,再把所有删除操作委派给并行的深度智能体执行。整体分为五个阶段。

一、用途 该技能用于从项目中移除未使用的代码。资料描述其特点为超工作模式(ultrawork mode)、经 LSP 验证的安全性,以及原子提交(atomic commits)。触发场景包括:remove dead code、dead code、cleanup、remove unused。

二、主要能力与工作流程

阶段 1:扫描(SCAN)——查找死代码候选。并行运行以下检查:

  • TypeScript 严格模式(主扫描器,优先运行): bunx tsc --noEmit --noUnusedLocals --noUnusedParameters 2>&1 该命令给出未使用的局部变量、导入、参数与类型的明确清单,带精确 file:line 位置。
  • 探查智能体(可全部作为后台任务同时启动): · 查找孤立文件:找出 src/ 中未被任何其他文件导入的文件。排除项:index.ts、*.test.ts、入口点、.md、packages/。返回文件路径。 · 查找未使用的导出符号:找出 src/ 中从未被其他文件导入的导出函数/类型/常量。交叉核对方式:对每个导出,在 src/ 中 grep 该符号名——若只出现在自身文件中,即为候选。排除项:src/index.ts 的导出、测试文件。返回文件路径、行、符号名、导出类型。
  • 将所有结果汇总为主候选清单。

阶段 2:验证(VERIFY)——LSP 确认,零误报。对阶段 1 的每个候选执行: LspFindReferences(filePath, line, character, includeDeclaration=false) 0 个引用 → 确认为死代码;1 个及以上引用 → 非死代码,从清单中剔除。 同时应用误报防护,产出确认清单,包含列:#、File、Symbol、Type、Action。动作类型包括: REMOVE —— 完全删除该符号/导入/文件; PREFIX _ —— 签名所需的未使用函数参数,重命名为 _paramName。 若确认数为零:报告“No dead code found”并停止。

阶段 3:分批(BATCH)——按文件分组以实现无冲突并行。目标是在无 git 冲突的前提下最大化并行智能体数量:

  • 按文件路径对已确认项分组;
  • 同一文件的所有项放入同一批(防止两个智能体编辑同一文件);
  • 若存在整个死文件需删除,则单独成批;
  • 目标为 5–15 批;若总数少于 5 项,则每项 1 批。 资料给出分批示例:批次 A 为一个文件中的 3 个未使用导入;批次 B 为一个文件中的 2 个未使用常量与 1 个死函数;批次 C 为一个工具的 1 个未使用参数与另一个文件的 1 个未使用类型;批次 D 为整个死文件的删除。同一目录下的文件可以合批,只要没有两个智能体编辑同一文件。

阶段 4:执行(EXECUTE)——启动并行深度智能体。每批启动一个深度智能体,携带技能 typescript-programmer 与 git-master,作为后台任务运行。每个智能体收到的提示结构包括:任务说明(从指定文件列表移除死代码)、待移除死代码清单(文件路径、行号、符号、类型、动作)、协议、以及关键约束。

协议步骤:

  1. 读取每个文件,理解目标行的确切语法;
  2. 对每个符号运行 LspFindReferences 重新验证其仍为死代码(其他智能体可能已改动);
  3. 应用修改:
    • 未使用导入(该行仅此符号):删除整个导入行;
    • 未使用导入(多个符号之一):仅从导入列表中移除该符号;
    • 未使用常量/函数/类型:移除声明,清理行尾空行;
    • 未使用参数:加 _ 前缀(不要删除——签名需要);
    • 死文件:用 rm 删除;
  4. 本批全部编辑完成后运行:bun run typecheck;
  5. 若类型检查失败:git checkout -- [files] 并报告失败;
  6. 若类型检查通过:仅暂存本批文件并提交: git add [your-specific-files] && git commit -m "refactor: remove dead code from [brief file list]";
  7. 报告移除了什么以及提交哈希。

关键约束(CRITICAL):

  • 只暂存本批文件(git add [specific files]),绝不使用 git add -A——其他智能体正在并行工作;
  • 若编辑后类型检查失败,回滚所有更改并报告,不要尝试修复;
  • 其他文件中的既有测试失败属预期情况,对本批而言只有类型检查重要。 所有批次同时启动,等待全部完成。

阶段 5:最终验证(FINAL VERIFICATION)。在所有智能体完成后运行: bun run typecheck(必须通过) bun test(记录与既有失败相比的新增失败) bun run build(必须通过) 并产出汇总,包含:已移除清单(#、符号、文件、类型、提交、批次)、跳过清单(含原因)、验证结果(类型检查通过/失败、测试 X 通过 Y 失败其中 Z 为既有失败、构建通过/失败、共移除 N 个符号跨 M 个文件、共 K 个原子提交、使用的并行智能体数 P)。

三、使用方式

  • 可通过 $ARGUMENTS 缩小扫描范围:文件路径 → 仅该文件;目录 → 仅该目录;符号名 → 仅该符号;all 或留空 → 全项目扫描(默认)。
  • 中止条件(ABORT CONDITIONS):发现超过 50 个候选时停止并报告(请用户缩小范围或确认继续);构建失败且无法通过回滚修复时停止。

四、适用场景 适用于需要批量清理 TypeScript 项目中死代码的场景,尤其是希望以并行方式加速、同时保证不破坏类型检查与构建、并通过原子提交保留可回滚性的工程流程。

五、限制

  • 资料明确其类型检查依赖 bun 工具链(bunx tsc、bun run typecheck、bun test、bun run build),以及 LSP 引用查找能力;若项目环境不具备这些条件,资料未提供替代方案。
  • 资料未说明对其他语言或框架的支持情况。
  • 资料未提供收费、价格、安装步骤等细节,这些内容暂未提供。