前言¶

团队里仍有大量 Android 或 Java 项目以 Gradle 构建。当需要接入只认 pom.xml 的流水线、统一 Maven 私服策略，或和仍以 Maven 为主线的模块对齐时，手工对照 build.gradle / build.gradle.kts 写 POM，往往要处理依赖坐标、插件、多模块结构和仓库声明，耗时长且容易漏项。下面介绍 SkillHub 上的社区 Skill「Gradle转Maven」，把迁移流程交给已安装该 Skill 的 AI Agent 按规范引导，你在本地完成改文件与验证。

这是什么¶

「Gradle转Maven」是面向 Gradle → Maven 迁移的通用 Agent Skill，坐标为 @user_50dee564/gradle2maven，当前版本 0.1.0，来源为 community，由发布者 user_50dee564 维护，在 SkillHub 分类为 dev-programming。官方说明将其定位为通用的 Gradle 向 Maven 迁移能力；标签 requires_api_key=false，安装使用不依赖额外 API Key。

Skill 页面与 API 入口：

• 展示页：https://www.skillhub.cn/skills/user_50dee564/gradle2maven
• API：https://api.skillhub.cn/user_50dee564/gradle2maven

核心功能¶

根据 SkillHub 已公开的简介，本 Skill 目前可核实的能力边界如下：

1. 迁移目标明确：面向将 Gradle 构建体系迁移为 Maven（pom.xml 及 Maven 惯用目录与依赖表达方式），而非泛泛的构建工具咨询。
2. 通用性：描述为「通用的」迁移 Skill，不绑定某一固定 Gradle 版本或单一框架模板；具体步骤与检查项以安装后包内的 SKILL.md 为准。
3. 本地执行、自行担责：作者说明为无偿分享，使用者需自行把控本地改动的风险，不对最终结果与产出质量负责。

页面统计（以 SkillHub 抓取为准）：评分 100000，下载 769 次，安装计数 0（统计随平台更新可能变化）。

安装与启用¶

Skill 遵循通用 SKILL.md 格式。在 SkillHub 上推荐的安装方式是：让 AI 按官方安装文档操作，并指定本 Skill 坐标。

1、安装 SkillHub CLI（若尚未安装）¶

先确认是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装或仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明见：https://skillhub.cn/install/skillhub.md

2、安装本 Skill 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 可能无法被加载。

在 Cursor 中，常用路径为：

skillhub install user_50dee564/gradle2maven --dir ~/.cursor/skills/

其他客户端路径以安装文档第四节为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下 .agents/skills/。坐标在 CLI 中通常写作 user_50dee564/gradle2maven（与页面上的 @user_50dee564/gradle2maven 对应）。

3、通过提示词让 AI 代为安装（官方页面文案）¶

SkillHub 技能页提供的安装提示词为：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_50dee564/gradle2maven`。

将上述内容发给已支持 Skill 的 AI 客户端，由 Agent 按文档完成 CLI 检查、目录选择与安装。安装后按客户端要求重启或刷新 Skill 列表，使 gradle2maven 生效。

典型用法¶

公开资料未单独列出逐步迁移命令行示例；可复现的入口如下。

1. 按上一节完成安装，确认 Skill 已出现在当前 Agent 的 skills 目录。
2. 在待迁移的 Gradle 工程工作区中打开对话，说明目标（例如生成根 pom.xml、对齐子模块、迁移依赖与仓库配置），并引用本 Skill 名称或坐标，让 Agent 按 SKILL.md 中的流程推进。
3. 在本地执行 Agent 建议的 mvn 校验（如 mvn -q validate、mvn test 等），用 Git 分支保留 Gradle 侧文件直至验证通过。

若需核对 Agent 行为是否与作者意图一致，安装后可直接阅读该 Skill 包内的 SKILL.md，再按其中步骤与当前仓库的 settings.gradle、build.gradle 实际情况调整。

适用场景与注意¶

适合谁

• 需要将现有 Gradle 项目迁到 Maven，并希望对话式、分步梳理依赖与模块结构的开发者。
• 已使用 Cursor、Claude Code、Codex 等支持 SkillHub 安装方式的 AI 客户端的团队。

限制与注意

• 社区 Skill（community），版本 0.1.0，迁移结果需自行审查与测试；复杂自定义插件、Kotlin DSL 专有逻辑、与 Gradle 强绑定的任务链，不一定能一键等价映射到 Maven。
• 作者已声明不对最终质量负责，生产环境迁移前请备份并在分支上迭代。
• 未要求 API Key，但迁移仍涉及改构建脚本与依赖，注意私服凭证与 settings.xml 不要误提交。

结尾¶

「Gradle转Maven」把 Gradle 向 Maven 的迁移收敛为可安装的 Agent Skill，配合 SkillHub 安装流程即可接入 Cursor 等环境。迁移细节以安装后的 SKILL.md 为准，官方展示页：https://www.skillhub.cn/skills/user_50dee564/gradle2maven