SuperAPI AI 工具集

dead-code-sweep

编程与开发

查看项目

更新于 10-16 03:39

技能介绍

用途:系统性识别并移除代码库中的死代码、冗余实现和孤立产物,重点针对由编码智能体维护、上下文窗口有限的代码库。

主要能力:按阶段工作。第一阶段确定分析边界并盘点语言、入口点、构建系统、包结构与大致代码行数。第二阶段并行扫描多类问题:孤立文件、未使用导出、冗余实现、过时兼容代码、死分支、孤立测试、孤立依赖。检测时用 Grep 和 Glob 搜索,并追踪引用验证;同时检查 CI 脚本与 shell 测试夹具中的路径引用,例如 rg <filename> -- scripts/ tests/ .github/。第三阶段把结果汇总到 .claude/dead-code-report.md,按置信度与类别组织,记录文件路径、行范围、判定理由与置信度。第四阶段先向用户展示摘要并请求批准,再按类别移除,清理相关导入与空文件、移除孤立依赖,并运行项目的 lint、类型检查或构建命令验证;若移除导致构建或类型错误,立即回滚该项并转为待复核。

使用方式:用户可指定目录、文件模式或模块作为范围;未指定时分析整个代码库。检测原则包括从入口点做可达性追踪、尊重模块边界(公共 API 的死代码标为待复核)、关注成簇出现的死代码、利用 git 历史判断、并检查 CI 与测试基础设施。

适用场景:清理长期由智能体迭代、积累了大量废弃代码的仓库。

限制:需防范动态派发、反射、字符串查找、框架约定导出、特性开关、装饰器或插件注册、CLI 入口、模板中的动态 CSS 类名等误报;不确定时标为待复核而非确认死亡。具体安装命令、收费与平台信息暂未提供。