Azure Skills 是什么:微软给编程 Agent 的 Azure 插件

微软官方仓库 microsoft/azure-skills 今天整组冲上 skills.sh 趋势榜:28 个 Azure Skill 排在第 7 到第 34 位,每个约 1.8 万次安装。它是一个给编程 Agent 用的插件,把 Azure 部署、排障、合规、配额这些活写成带护栏的 Skill,再接上 Azure MCP Server 去动真资源。截至 2026-11-03(北京时间),最新版 v1.2.110,MIT 许可,Claude Code、GitHub Copilot、Cursor、Codex、Gemini CLI 都能装。
它是什么
Azure Skills Plugin 是微软给编程 Agent 做的 Azure 能力包。README 开头讲,Azure 上的活有一大半是做决定:选哪个服务、部署前验什么、该跑哪些工具、哪里要设护栏。Skill 负责把这些决定写成流程和决策树,MCP 工具负责去订阅里查资源、看日志、跑部署。仓库内容从 microsoft/GitHub-Copilot-for-Azure 自动同步,改动要到那边提 PR。
| 仓库 | github.com/microsoft/azure-skills |
|---|---|
| 作者 | Microsoft |
| 许可证 | MIT |
| 热度 | skills.sh 趋势榜 28 个 Skill 占第 7–34 位,每个 17,982–18,079 次(2026-11-03 北京时间约 15:10 抓取,11-02 快照里还没有);累计安装 microsoft-foundry 约 60.3 万、azure-diagnostics 约 59.3 万;GitHub 1,613 星(GitHub API,同日);Azure MCP Server 的 npm 包 @azure/mcp 2026-10-26 至 11-01 周下载 165,422 |
| 运行要求 | Azure 账号或订阅;Node.js 18+(用 npx 起 MCP);Azure CLI 并 az login;用部署流程再装 Azure Developer CLI 并 azd auth login |
| 最新版本 | v1.2.110(GitHub 发布于 2026-11-03 02:11,北京时间;改动:采用 Agent Plugins 1.0 包格式) |
解决什么问题
让通用编程 Agent 帮你上 Azure,常见结果是给一段泛泛的云建议,或者直接生成一份 Bicep 就跑 azd up,配额不够、角色没配、SQL 管理员密码写进模板,这些都要等报错才发现。这个插件的思路是把微软自己的部署和排障经验写成 Skill,Agent 遇到 Azure 任务时按需加载,按流程走。
我把仓库 .github/plugins/azure-skills/skills/ 目录翻了一遍,当前是 28 个 Skill,大致分四类:
| 场景 | 代表 Skill | 干什么 |
|---|---|---|
| 构建与部署 | azure-prepare / azure-validate / azure-deploy | 生成 azure.yaml、Bicep 或 Terraform、Dockerfile;预检;执行 azd up 并处理报错 |
| 排障与治理 | azure-diagnostics / azure-compliance / azure-quotas | AppLens、Azure Monitor 排障;azqr 合规扫描和 Key Vault 过期检查;查配额和可用区域 |
| 架构与迁移 | azure-compute / azure-resource-visualizer / azure-cloud-migrate | 选型、画资源关系图、从别的云迁过来 |
| 数据、AI、身份 | azure-ai / microsoft-foundry / entra-app-registration / azure-kusto | Foundry 模型与 Agent、Entra 应用注册、KQL 查询 |
README 里还列了 azure-cost、azure-rbac、azure-hosted-copilot-sdk,但它们不在当前 skills 目录里(skills.sh 上仍有历史条目)。装之前以目录为准。
怎么用
Claude Code 直接从官方插件市场装:
/plugin install azure@claude-plugins-official
/plugin update azure@claude-plugins-official # 以后升级
GitHub Copilot CLI 和 Codex CLI 先加市场再装:
# Copilot CLI
/plugin marketplace add microsoft/azure-skills
/plugin install azure@azure-skills
# Codex CLI
codex plugin marketplace add microsoft/azure-skills
# 然后 /plugins 里装 azure,/skills 里按需开关单个 Skill
Gemini CLI 是 gemini extensions install https://github.com/microsoft/azure-skills;Cursor 在 Settings → Plugins 搜 Azure;用微软 APM 的可以 apm install microsoft/azure-skills 一次装到多个宿主。只想要 Skill、不要插件里的 MCP 配置,官方给的是 skills CLI 写法(skills CLI 用法见站内旧文):
npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
插件带的 MCP 配置很短,就是用 npx 拉最新的 Azure MCP Server:
{
"mcpServers": {
"azure": {
"command": "npx",
"args": ["-y", "@azure/mcp@latest", "server", "start"]
}
}
}
装好后先登录,再用官方给的三句话自检:
az login
azd auth login # 要用 azd 部署时
# 在 Agent 里依次问:
# What Azure services would I need to deploy this project?
# List my Azure resource groups.
# What AI models are available in Microsoft Foundry?
第一句看 Skill 层有没有生效(应该给结构化的服务建议),第二句看 Azure MCP 能不能读到你的订阅,第三句看 Foundry MCP。如果你对 MCP 还不熟,先看站内入门再装。
部署链为什么要分三步
部署三件套之间有硬约束,这是整套 Skill 里我觉得最实用的部分。azure-prepare 第一件事是在项目根目录写 .azure/deployment-plan.md 骨架,边分析边填,给你看过再往下走;它只生成配置,不执行部署。azure-validate 检查这份计划状态,没有就让 Agent 停下回去跑 prepare,预检进度记在 .azure/validate-status.json。azure-deploy 要求计划状态是 Validated,并且明确禁止 Agent 自己改状态绕过预检。
azure-deploy 的 SKILL.md 明写:只有 azure-validate 跑完真实检查后才能把计划标成 Validated,Agent 不准自己改。
其他几条规则也是冲着常见事故写的:破坏性操作要先 ask_user;不准删用户的项目目录,已有项目里不跑 azd init -t;生成 SQL Server 的 Bicep 时不准出现管理员账号密码,一律 Entra 认证。azure-diagnostics 支持只看你贴的日志和指标做诊断,你说不许碰线上,它就不查也不改。
要注意的地方
国内 Azure 要改配置。MCP 默认连 Azure 公有云。用世纪互联运营的 Azure 中国区,要给 MCP 命令加 --cloud AzureChinaCloud,本地 CLI 也要切过去:
az cloud set --name AzureChinaCloud && az login
azd config set cloud.name AzureChinaCloud && azd auth login
遥测默认开。README 给的关闭方法是 export AZURE_MCP_COLLECT_TELEMETRY=false。
权限就是你账号的权限。MCP 用你的 az login 凭据或托管身份,能做什么取决于订阅里的 RBAC。Microsoft Learn 还写明本地 MCP 只用于组织内部开发环境,别拿去对外服务。在生产订阅里用,最好换一个只读或限定资源组的身份。
@latest 拉到的是 beta。2026-11-03 查 npm,@azure/mcp 的 latest 标签指向 4.0.0-beta.4(10-29 发布)。想锁版本,就把配置里的 @latest 改成具体版本号。
适合谁,不适合谁
适合:已经在 Azure 上跑应用、想让 Claude Code 或 Copilot 帮着部署、排障、查配额的团队;做 Foundry 模型和 Agent 的开发者(站内写过 Copilot harness 接 Foundry);想参考大厂怎么写带护栏的部署 Skill 的人,可以直接翻这批 SKILL.md 当参考。
不适合:没有 Azure 订阅的,大部分 Skill 用不上;主力在阿里云、腾讯云或 AWS 的,这套流程和工具绑定 Azure,换不过去;只想问问概念、不打算让 Agent 碰订阅的,看官方文档就够。
最后
手上有 Azure 项目的话,在 Claude Code 里跑一次 /plugin install azure@claude-plugins-official,az login 后让 Agent 走一遍 prepare → validate,先看它写出的 .azure/deployment-plan.md 合不合你的意,再决定要不要让它 deploy。