pom-factory-skill.md 2.7 KB


name: pom-management

description: 用于多模块 Java 项目的 Maven pom.xml 规范治理,覆盖父子继承、dependencyManagement/pluginManagement、版本统一、依赖清理与风险检查。用户提到整理 POM 规范、审查依赖、优化模块 POM、移除 systemPath、输出整改建议时使用。

POM 管理 Skill

目的

使用该 Skill 产出一致、可执行的 Maven POM 治理结果,适用于多模块项目。

聚焦以下方面:

  • 父子继承关系一致性
  • 版本集中管理
  • 依赖与插件治理
  • 构建可复现与 CI 友好性

触发条件

当用户提出以下诉求时启用:

  • "整理 POM 规范" / "POM 管理规范"
  • "检查/优化 pom.xml"
  • "依赖版本统一"
  • "提出整改建议"
  • "去除 systemPath/system scope"
  • "治理 Maven 多模块结构"
  • "调整系统结构"

    默认工作流

  1. 识别 POM 拓扑
  2. 定位根 POM、聚合 POM、业务模块 POM。
  3. 确认父链是否连续且一致。

  4. 检查版本治理

  5. 检查根 POM 的 properties

  6. 检查根 POM 的 dependencyManagement

  7. 检查根 POM 的 pluginManagement

  8. 标记应上收但仍写在子模块中的硬编码版本。

  9. 检查依赖质量风险

  10. 标记 scope=systemsystemPath

  11. 标记动态或不稳定版本(LATESTRELEASE、区间版本、生产场景下的 -SNAPSHOT)。

  12. 标记重复依赖与冲突依赖。

  13. 标记无明确理由的通配排除(*:*)。

  14. 检查 Java 与框架版本对齐

  15. 对比各模块 java.versionmaven.compiler.source/target/release

  16. 对比 Spring Boot、Spring Cloud、MyBatis 等核心技术栈版本。

  17. 按优先级输出结果

  18. P0:必须立即处理(构建不可移植、父链分裂、硬冲突)

  19. P1:短期一致性优化

  20. P2:长期可维护性优化

POM 治理规则

规范条文(必须/禁止/推荐)已提取至 Cursor 规则 ../../../../rules/java/java-pom-governance.mdc;本 Skill 仅保留工作流与输出模板。

输出模板

最终回复建议使用以下结构:

## POM 规范建议
- [规则 1]
- [规则 2]

## 发现的问题
- P0: [问题 + 影响 + 位置]
- P1: [问题 + 影响 + 位置]
- P2: [问题 + 影响 + 位置]

## 修改建议
- [建议 1:怎么改]
- [建议 2:怎么改]

## 可执行下一步
- [步骤 1]
- [步骤 2]

变更执行指引

当用户要求落地修改时:

  • 先只改用户要求范围(例如仅文档,或仅 POM 代码)。
  • 保持与任务无关的本地改动不被影响。
  • 改动后执行轻量校验(如可用,在相关模块运行 mvn -q -DskipTests validate)。
  • 清晰说明“已改内容”与“后续待办”。