java-pom-governance.mdc 1.1 KB

1234567891011121314151617181920212223242526272829303132
  1. ---
  2. description: Maven 多模块 POM 治理必须/禁止/推荐项(dependencyManagement、pluginManagement、禁止 systemPath 等)
  3. globs: "**/pom.xml"
  4. alwaysApply: false
  5. ---
  6. # POM 治理规则(从 pom-factory-skill 提取)
  7. 适用于多模块 Java 项目的 `pom.xml` 规范治理。
  8. ## 必须项
  9. - 根 POM 通过 `properties` + `dependencyManagement` 管理共享版本。
  10. - 根 POM 通过 `pluginManagement` 管理插件版本。
  11. - 业务子模块默认只声明依赖,不写版本;例外必须说明原因。
  12. - 非必要不显式声明 `compile` scope。
  13. - 全项目使用统一 Java 基线并强制执行。
  14. ## 禁止项
  15. - 常规构建中使用 `systemPath` 或 `scope=system`
  16. - 使用 `LATEST` / `RELEASE` / 开放区间版本
  17. - 同级模块采用不一致的父 POM 策略
  18. - 无明确理由使用大范围通配排除
  19. ## 推荐项
  20. - 使用 `maven-enforcer-plugin` 做基线约束
  21. - 启用 `dependencyConvergence` 和重复依赖检查
  22. - 模块 POM 保持精简且语义明确
  23. > 完整工作流与输出模板仍见记忆库:`tofly-memory-system/language/java/pom-factory-skill.md`。