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