java-g2m

Files (1)

• SKILL.md

SKILL.md (first lines)

# Gradle 转 Maven

## 适用场景

- 项目构建体系需要从 Gradle 统一到 Maven
- 已有项目需要接入只支持 Maven 的 CI 或制品流程

## 前置条件

1. 通过 skill `java-env` 确认 JDK 与 mvnd/mvn 版本。
2. 阅读 `build.gradle` / `build.gradle.kts`、`settings.gradle`、`gradle.properties` 与 `gradle/libs.versions.toml`。
3. 确认多模块结构与模块间依赖关系。

## 迁移要求

1. 保持 JDK 要求不变；除非用户明确要求切换 JDK。
2. 所有依赖必须完整迁移到 `pom.xml`，不重不漏，作用域（compile/provided/runtime/test）与原构建一致。
3. Gradle 特有任务尽可能等价迁移为 Maven 插件或 profile；无法迁移的，在输出中列出任务清单、原因与替代方案。
4. 多模块项目使用 Maven 聚合与继承结构，模块坐标、依赖关系与原结构一致。
5. 版本号统一由 `dependencyManagement` 或 parent 管理，避免散落。

## 执行步骤

1. 盘点 Gradle 结构：模块、插件、依赖、仓库、属性、任务。
2. 生成或改写 `pom.xml`：parent、modules、properties、dependencyManagement、dependencies、build。
3. 迁移资源过滤、打包配置、测试配置与编码设置。
4. 逐模块执行 `mvnd -q -DskipTests compile`，修正依赖与插件差异。
5. 执行 `mvnd test`，确认测试全部通过。
6. 对比迁移前后构建产物与依赖树（`mvnd dependency:tree`）。

## 输出物

- 迁移后的 `pom.xml`（含多模块）。
- 迁移说明：依赖映射、插件映射、未能迁移的任务清单。
- 验证记录：编译、测试、依赖树对比结果。

## 完成标准

- [ ] 所有模块可编译
- [ ] 所有测试通过
- [ ] 依赖无缺失、无重复、作用域正确
- [ ] 未能迁移的 Gradle 任务已列出并有替代方案

From hellyguo/self-ai-spec, Apache-2.0.

More from hellyguo/self-ai-spec