1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | azure-cloud-migrate-microsoft-azure-skills |
| 作者/维护者 | Microsoft（官方，通过独立分发仓库 microsoft/azure-skills 发布，内容同步自开发仓库 microsoft/GitHub-Copilot-for-Azure） |
| 来源链接 | https://github.com/microsoft/azure-skills/tree/main/skills/azure-cloud-migrate |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars / Forks | 1,345 / 224（数据来自 GitHub API，2026-08-01；该数字属整个 azure-skills 插件仓库（28 个子技能共享），不代表本技能自身热度） |
| 最新版本 | SKILL.md 内 metadata 版本 1.3.1 |
| 安装方式 | APM 一条命令跨 Host 安装，或 Claude Code / Codex CLI / GitHub Copilot CLI / Cursor / Gemini CLI 各自的插件市场安装，或手动克隆后复制子目录 |
2. 功能介绍与亮点
本技能把“把其他云上已有工作负载搬到 Azure”这件事拆成评估、代码迁移两个明确阶段，覆盖 8 种主流跨云场景：AWS Lambda→Azure Functions、AWS Elastic Beanstalk/Heroku/Google App Engine→Azure App Service、AWS Fargate(ECS)/Kubernetes(GKE/EKS/自托管)/GCP Cloud Run/Spring Boot→Azure Container Apps。
- 每种场景都配有独立的 assessment（评估）与 code-migration（代码转换）参考文档，而不是一份笼统的通用指南
- 内置隐藏陷阱检测：会扫描源码中硬编码的服务发现地址（如 Kubernetes DNS 名
http://order-service:3001），因为这类地址迁移到 Container Apps 后无法直接解析，需改造成环境变量注入 - 明确规定“破坏性操作必须经用户确认（
ask_user）才能执行”，且全部迁移产物只写入独立的<workspace-root>-azure/目录，不改动源目录 - 长时间操作（部署、镜像推送）过程中要求向用户汇报资源级进度，避免用户长时间等待却看不到反馈
- 迁移完成后可交接给同仓库的
azure-prepare技能继续处理基础设施准备、测试与部署 - 亮点：微软为其单独建有 Microsoft Learn 官方文档页（
learn.microsoft.com/.../azure-skills/skills/azure-cloud-migrate，2026-07 更新），页面明确将 Claude Code 列为兼容 AI 助手；上游开发仓库为该技能建有专属自动化集成测试套件，近 3 个月内记录了 7 条专属 issue，其中包含针对真实功能缺陷（如输出目录路径识别错误）的修复记录，显示持续的专属维护投入而非一次性提交
3. 适用场景
所属分类：DevOps 与基础设施
适合正在把已有 AWS、GCP 或 Heroku 工作负载迁移到 Azure 的云架构师、平台工程师与 DevOps 团队，尤其是需要先拿到一份服务映射评估报告、再逐步做代码转换的场景——覆盖 Serverless 函数、传统 PaaS 应用与容器化工作负载三条主线。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——官方 README 与 Microsoft Learn 文档页均明确列出 Claude Code 为兼容 AI 助手，可通过
/plugin install azure@claude-plugins-official安装 - Codex：✅ 原生支持——官方 README 提供
codex plugin marketplace add microsoft/azure-skills后经/plugins安装的完整步骤，并支持用/skills单独启停某个技能 - OpenClaw：未验证——已抓取材料未提及
- Hermes Agent：未验证——已抓取材料未提及
5. 推荐理由
官方微软把 AWS/GCP/Heroku 到 Azure 的资产迁移拆成“先评估、后转码”两阶段工作流，覆盖 8 种主流跨云场景并各自配专属参考文档，还内置服务发现地址失效等隐藏陷阱检测与破坏性操作需用户确认的安全设计。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 独立分发仓库 1,345 星、MIT 协议；上游开发仓库 GitHub-Copilot-for-Azure 持续高频迭代；该子技能自身有专属自动化集成测试套件与 7 条专属 issue 记录（含真实功能缺陷修复），但作为细分子技能，尚未见独立于插件整体之外的专门第三方评测 |
| 可用性 | 8 | SKILL.md 结构清晰，8 种迁移场景各配独立 assessment + code-migration 参考文档；仅需 az login（涉及部署时另需 azd auth login）即可使用；子目录近期仍有实质性同步更新；SKILL.md metadata 版本号已迭代至 1.3.1，显示持续打磨 |
| 安全性 | 8 | 会生成/修改代码并可能触发实际部署，权限范围比纯只读诊断类技能更宽；但明确将破坏性操作网关到用户确认（ask_user）后才执行，且全部输出限定在独立 <workspace>-azure/ 目录、不修改源码；复用用户已有的 az/azd 登录会话，不单独存储凭据；MIT 协议清晰，官方 Microsoft 出品 |
综合评分 = 三项均值 = 7.7
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
awslabs/agent-plugins（AWS 官方） |
面向已经在 AWS 上运行的团队，帮 Agent 架构设计、部署、运维 AWS 原生资源 | 服务方向相反：一个帮用户更好地用 AWS，本技能帮用户把已有 AWS/GCP/Heroku 工作负载迁移出来搬到 Azure；两者是跨云迁移链条的两端而非同类竞品 |
kubernetes-skill（lukasniessen） |
用六大失效模式诊断工作流，堵住 Agent 生成 K8s manifest 时的安全默认值问题，聚焦日常 K8s 配置审查 | 是“如何写好 Kubernetes manifest 本身”的通用参考，不涉及云厂商切换；本技能只负责“把其他云上的 Kubernetes 工作负载迁移到 Azure Container Apps”这一具体转码动作，两者面向的是配置审查与迁移执行两种不同任务 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；已核实到的第三方参与是同仓库开发链路上的自动化集成测试与真实功能缺陷修复记录（详见第 2 章），但均属工程维护活动，不构成用户评价。
9. 其他补充
该插件采用 APM（Agent Package Manager）统一分发协议，apm install microsoft/azure-skills 一条命令即可跨 GitHub Copilot、Claude Code、Cursor、OpenCode、Codex、Gemini 六种 Host 完成安装；Microsoft Learn 文档页额外提供 9 条可直接使用的激活提示语（如“Migrate my Lambda functions to Azure Functions”）。
10. 安装使用方式
- APM 一键安装（多 Host）：
apm install microsoft/azure-skills - Claude Code：
/plugin install azure@claude-plugins-official，或运行/plugin搜索 “azure” - Codex CLI：先
codex plugin marketplace add microsoft/azure-skills，再通过/plugins安装 azure 插件 - GitHub Copilot CLI：
/plugin marketplace add microsoft/azure-skills后/plugin install azure@azure-skills - 手动安装：
git clone https://github.com/microsoft/azure-skills.git，将skills/azure-cloud-migrate目录复制或软链接到目标 agent 的 skills 目录 - 安装后注意事项：需本机已安装 Azure CLI（
az login登录）；若计划直接触发部署，另需 Azure Developer CLI（azd auth login）；本机 PATH 中需有 Node.js 18+，因为该插件的 MCP Server 通过npx启动
11. 注意事项
- 该技能会实际生成/修改代码，涉及部署时权限范围比同仓库纯只读诊断类技能更宽，请留意破坏性操作确认提示，不要无脑批准
- 迁移产物统一写入工作区根目录旁的
<workspace-root-basename>-azure/目录；若工作区目录名本身较特殊，需确认脚本正确识别了工作区根目录而非误判为父目录 - 该技能与仓库内其余 27 个 Azure 子技能共享同一 Azure MCP Server 基础设施，安装的是整套 Azure Skills 插件而非单独该技能；Codex 用户可通过
/skills选择性启停不需要的技能以缩小上下文 - 当前仅覆盖 8 种预置迁移场景，若源云服务不在列表中，技能会转而调用通用 Azure 文档与最佳实践工具，深度不如预置场景