mcpField
D
dead-code-cleanup

dead-code-cleanup

github.com/repowise-dev开发8.0k91 次安装今天更新
代码仓库

关于 dead-code-cleanup

Repowise 的死代码清理技能通过代码图分析识别疑似未使用的文件、导出符号和软件包,供开发者评估清理。结果按置信度分类,并提供安全删除判断与依赖复核步骤。

主要功能

  1. 01识别不可达文件与未使用导出
  2. 02发现无消费者的软件包
  3. 03按置信度筛选结果
  4. 04按目录或所有者汇总
  5. 05删除前检查依赖风险

适用场景

  1. 01清理旧目录中的未使用代码
  2. 02定位没有消费者的单体仓库软件包
  3. 03筛选适合安全删除的项目
  4. 04删除前核对文件依赖关系

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/repowise-dev/repowise --skill dead-code-cleanup

安装后在 Claude Code 中输入/dead-code-cleanup确认已加载。

详细介绍

使用 Repowise 清理死代码

Repowise 通过图分析检测死代码,无需 LLM,即使使用模板渲染的 Wiki 也能正常工作。

用户询问死代码/未使用代码时

调用 get_dead_code(),获取按置信度等级排序的发现结果。实用参数:

  • safe_only=true — 仅显示已确认可安全删除的发现(置信度 >= 0.7)
  • kind="unreachable_file" — 没有导入者的文件
  • kind="unused_export" — 无人使用的公共符号
  • kind="zombie_package" — 没有使用方的单体仓库包
  • directory="src/old/" — 限定在特定目录中
  • tier="high" — 仅显示高置信度的发现(>= 0.8)
  • min_confidence=0.7 — 提高置信度下限(默认值为 0.5),以便进行可用于发布的清理
  • group_by="directory" 或 group_by="owner" — 汇总查看死代码集中在哪些位置,以及哪些负责人拥有的死代码最多

如何呈现发现结果

  • 仅建议删除 safe_to_delete: true 的发现
  • 对于置信度较低的发现,应将其表述为“待调查的候选项”,而不是“要删除的内容”
  • 动态加载的代码(插件、处理程序、适配器)可能会被识别为死代码,但实际上并非如此——Repowise 会过滤常见模式,但仍存在边缘情况

删除任何内容之前

  1. 征求用户确认。提供文件/符号名称、置信度分数,以及 Repowise 认为它是死代码的原因。
  2. 调用 get_risk(targets=["path/to/file"]),再次检查依赖项。
  3. 最近修改过的“死代码”更可能是误报——如果该发现近期有 Git 活动,请指出这一点。

安全删除顺序

  1. 首先删除不可达文件(移除整个文件,最干净)
  2. 接着删除未使用的内部符号
  3. 最后删除未使用的导出项(由于可能存在动态导入,误报风险最高)

评论

支持 Markdown