关于 dead-code-cleanup
Repowise 的死代码清理技能通过代码图分析识别疑似未使用的文件、导出符号和软件包,供开发者评估清理。结果按置信度分类,并提供安全删除判断与依赖复核步骤。
主要功能
- 01识别不可达文件与未使用导出
- 02发现无消费者的软件包
- 03按置信度筛选结果
- 04按目录或所有者汇总
- 05删除前检查依赖风险
适用场景
- 01清理旧目录中的未使用代码
- 02定位没有消费者的单体仓库软件包
- 03筛选适合安全删除的项目
- 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 会过滤常见模式,但仍存在边缘情况
删除任何内容之前
- 征求用户确认。提供文件/符号名称、置信度分数,以及 Repowise 认为它是死代码的原因。
- 调用
get_risk(targets=["path/to/file"]),再次检查依赖项。 - 最近修改过的“死代码”更可能是误报——如果该发现近期有 Git 活动,请指出这一点。
安全删除顺序
- 首先删除不可达文件(移除整个文件,最干净)
- 接着删除未使用的内部符号
- 最后删除未使用的导出项(由于可能存在动态导入,误报风险最高)
评论
支持 Markdown