技能介绍

要解决什么问题

项目变「乱」往往不是因为语法错或 lint 没过，而是结构层面的债务：入口再也走不到的文件、同一模块叠了 v1～v5 好几份、删目录时漏了 memory/memory/ 这种嵌套、dist/ 和 node_modules/ 和源码混在同一棵树里，还有 heartbeat-log/ 和 heartbeat-logs/ 并存。更麻烦的是脚本删了进程还在跑。这类问题 linter 不会报，人工全库 grep 又容易漏。

技能如何工作

本技能把扫描范围限定在可清理性，不做语法、性能或代码风格审查。典型流程是：你指定项目根目录，通过 run-scanner.cjs 在临时目录解码并执行扫描器（规避平台 WAF 对载荷的拦截），生成结构化报告后，由 AI 按风险分层给建议：

可立即删除：沿 require/import 从入口追引用链，链外且已确认未使用的文件
需先确认：改动面大或可能影响运行时行为的项
可先归档：暂不删，移到 _archive/ 等目录

报告侧会覆盖：未被引用的文件、多版本同文件并存、嵌套重复目录、构建产物混入源目录、同一项目内连字符与下划线命名混用、语义重复的目录名，以及僵尸进程（对应脚本已不存在但进程仍在）。

适用边界与注意点

已被 git 跟踪但未出现在引用链上的文件，仍会被算作死代码候选——删之前要对照业务与部署路径。大仓库（例如超过约一万个文件）扫描会偏慢，宜配合 --limit；任何批量删除前建议 dry-run，避免误删。语法错误、代码质量与性能问题请交给 linter 和 profiling，不要指望本技能替代它们。