agentsclimarketplace

Nbl.refactor clean

Skill icefrag/nbl-superpowers/skills/nbl.refactor-clean

Java Web 死代码清理和重构专家。安全识别并移除死代码,每一步都进行测试验证。 触发条件:用户请求清理死代码、重构优化、移除未使用代码。From its SKILL.md

Install
npx -y skills add icefrag/nbl-superpowers --skill nbl.refactor-clean

Assembled 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:安全删除循环

对于每个安全级别的项:

  1. 运行完整测试套件 — 建立基线(全部通过)
    mvn clean test
    
  2. 删除死代码 — 使用Edit工具精确移除
  3. 重新运行测试 — 验证没有破坏
    mvn test
    
  4. 如果测试失败 — 立即回滚 git checkout -- <file> 并跳过此项
  5. 如果测试通过 — 移至下一项

步骤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流程

Keep looking

Skills are one crate of 608,253. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.