Nbl.refactor clean
Java Web 死代码清理和重构专家。安全识别并移除死代码,每一步都进行测试验证。 触发条件:用户请求清理死代码、重构优化、移除未使用代码。From its SKILL.md
npx -y skills add icefrag/nbl-superpowers --skill nbl.refactor-cleanAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
4.3 KB, as published. Nobody here has run it
Refactor Clean Skill
安全识别并移除死代码,每一步都进行测试验证。
激活时机
- 用户请求清理死代码
- 代码维护优化
- 移除未使用代码
步骤1:检测死代码
根据项目类型运行分析工具:
| 工具 | 检测内容 | 命令 |
|---|---|---|
| Maven Dependency | 未使用的Maven依赖 | mvn dependency:analyze |
| SpotBugs | 静态代码分析 | mvn spotbugs:check |
| PMD | 代码质量检查+重复代码 | mvn pmd:check |
| JaCoCo | 测试覆盖率分析 | mvn test jacoco:report |
| Checkstyle | 代码规范检查 | mvn checkstyle:check |
如果没有专用工具,使用Grep查找零引用的公开方法:
# 查找类定义,然后检查是否被引用
grep -r "ClassName" --include="*.java" | grep -v "ClassName.java"
步骤2:分类检测结果
将检测结果按安全等级分类:
| 等级 | 示例 | 操作 |
|---|---|---|
| 安全 | 未使用的工具方法、私有方法、常量 | 可放心删除 |
| 谨慎 | Service方法、Controller方法、DTO类 | 验证无动态调用或外部消费者 |
| 危险 | Feign接口、Entity类、枚举类 | 调查后再决定 |
| 禁止 | api模块的公开接口、配置类 | 不允许删除 |
步骤3:安全删除循环
对于每个安全级别的项:
- 运行完整测试套件 — 建立基线(全部通过)
mvn clean test - 删除死代码 — 使用Edit工具精确移除
- 重新运行测试 — 验证没有破坏
mvn test - 如果测试失败 — 立即回滚
git checkout -- <file>并跳过此项 - 如果测试通过 — 移至下一项
步骤4:处理谨慎级别项
删除谨慎级别项之前:
- 搜索动态调用:反射
Class.forName()、Method.invoke() - 搜索字符串引用:配置文件中的类名、Spring Bean名称
- 检查是否被Feign接口导出
- 检查api模块中是否有对应的Req/Resp/Query对象引用
- 验证无其他微服务调用(检查api模块接口)
步骤5:合并重复代码
移除死代码后,检查:
- 相似方法(>80%相似)— 合并为一个
- 重复的DTO转换逻辑 — 使用MapStruct或提取工具方法
- 无价值的包装方法 — 直接内联调用
- 多余的中间层 — 移除不必要的委托
步骤6:总结
输出结果报告:
死代码清理报告
──────────────────────────────
已删除: 12个未使用方法
3个未使用类
5个未使用依赖
已跳过: 2项(测试失败)
节省: 约450行代码
──────────────────────────────
编译通过 ✅
测试通过 ✅
覆盖率: 85% ✅
Java Web项目特定规则
禁止删除
- api模块的Feign接口 — 可能被其他微服务调用
- Entity实体类 — MyBatis-Plus动态使用
- 枚举类(Enum后缀) — 可能被序列化/反序列化
- Mapper接口 — XML中的SQL可能动态调用
- Spring配置类 — 影响应用启动
分层架构检查
删除前验证是否违反分层:
# Controller不能直接调用Mapper
grep -r "Mapper" --include="*Controller.java" | grep -v "//"
# Service层禁止直接使用QueryWrapper
grep -r "QueryWrapper\|LambdaQueryWrapper" --include="*ServiceImpl.java"
Maven依赖清理
# 分析未使用的依赖
mvn dependency:analyze
# 关注输出:
# - Unused declared dependencies: 可安全移除
# - Used undeclared dependencies: 需要显式声明
核心规则
- 禁止不运行测试就删除
- 一次只删一个 — 原子变更使回滚更容易
- 不确定就跳过 — 保留死代码比破坏生产环境好
- 清理与重构分开 — 先清理,后重构
- 每批次后编译验证 —
mvn compile - 禁止修改接口URI path — refactor任务不得修改
@RequestMapping/@PostMapping/@GetMapping等注解的path值,路径变更须走feature流程