microsoft/azure-skills
GitHub: microsoft/azure-skills
微软官方的 Azure 智能体插件，通过集成专业知识技能层和 MCP 执行工具，让 AI 编程助手能够执行真实的 Azure 资源管理、部署与优化任务。
Stars: 1325 | Forks: 220
# Azure Skills 插件
Azure 的工作不仅仅是一个代码问题。它是一个决策问题：哪种服务适合此应用，在部署前需要验证什么，应该运行哪些工具，以及哪些防护措施很重要。Azure Skills 插件将 Azure 专业知识与基于 MCP 的执行打包在一起，使得兼容的编程代理能够执行真正的 Azure 工作，而不是提供通用的云建议。
**[浏览 Azure Skills 网站](https://microsoft.github.io/azure-skills/)**
**[落地页维护指南](landing-page/README.md)**
**[安装插件](#install-in-60-seconds)**
## 一次安装，三层能力
### Azure skills：大脑
此插件附带了经过精心策划的 **curated Azure skills**，用于教导代理如何完成 Azure 工作。它们为以下场景提供了工作流、决策树和防护措施：
- **构建、部署和演进**，使用 `azure-prepare`、`azure-validate`、`azure-deploy`、`azure-upgrade`、`azure-enterprise-infra-planner`、`azure-hosted-copilot-sdk`、`azure-kubernetes` 和 `airunway-aks-setup`
- **故障排除、监控和治理**，使用 `azure-diagnostics`、`appinsights-instrumentation`、`azure-compliance`、`azure-resource-lookup` 和 `azure-quotas`
- **优化架构和成本**，使用 `azure-cost`、`azure-compute`、`azure-resource-visualizer` 和 `azure-cloud-migrate`
- **跨数据、AI、身份和平台服务工作**，使用 `azure-ai`、`azure-aigateway`、`azure-storage`、`azure-kusto`、`azure-messaging`、`azure-rbac`、`entra-app-registration` 和 `microsoft-foundry`
### Azure MCP Server：双手
该插件接入了 **Azure MCP Server**，它为您的代理提供了 **跨越 40 多项 Azure 服务的 200 多种结构化工具**。这就是用于列出资源、检查价格、查询日志、诊断问题以及驱动实际 Azure 工作流的执行层。
### Foundry MCP：AI 专家
该插件还包括 **Foundry MCP**，用于 Microsoft Foundry 场景，例如模型发现、模型部署和代理工作流。
## 为什么这款插件与众不同
这不是一个提示词包。它是一个打包的 Azure 能力层：
- **Skills** 教导代理何时使用 Azure 工作流以及应避免什么。
- **MCP 工具** 让代理能够对实时的 Azure 和 Foundry 资源执行操作。
- **该插件** 将指导层和执行层保持在一次安装中对齐。
- **多主机支持** 让您能在不同环境中使用相同的 Azure 能力，例如 VS Code 中的 GitHub Copilot、Copilot CLI、Claude Code 以及其他兼容的主机。
## 您会获得什么
| 组件 | 它添加的内容 | 示例 |
| --- | --- | --- |
| **Azure skills** | Azure 专业知识、工作流和防护措施 | 准备、验证、部署、诊断、成本、AI、RBAC |
| **Azure MCP Server** | 实时 Azure 工具 | 资源清点、监控、定价、存储、数据库、消息传递 |
| **Foundry MCP** | Microsoft Foundry 工作流 | 模型目录、部署、代理、评估 |
插件的有效载荷位于 `.github/plugins/azure-skills/` 中，其中包含的 MCP 配置展示了如何为兼容的主机接入 Azure 和 Foundry 连接。
## 60 秒内安装
### 前置条件
在安装之前，请确保您具备：
- 一个 Azure 账户或订阅
- 您的 PATH 中有可用的 **Node.js 18+**（使用 `npx` 启动 MCP 服务器）
- 已安装 **Azure CLI** 并通过 `az login` 完成了身份验证
- 如果您计划使用部署工作流，请安装 **Azure Developer CLI** 并通过 `azd auth login` 完成身份验证
### APM（一次安装，多种环境）
Azure Skills 插件支持多种环境。如果您使用 [APM](https://github.com/microsoft/apm)，只需一条命令即可通过单个 `apm.yml` 将其安装到 GitHub Copilot、Claude Code、Cursor、OpenCode、Codex 和 Gemini 中：
```
apm install microsoft/azure-skills
```
### GitHub Copilot CLI
**添加市场**（仅限首次）：
```
/plugin marketplace add microsoft/azure-skills
```
**安装插件**：
```
/plugin install azure@azure-skills
```
**更新插件**：
```
/plugin update azure@azure-skills
```
### VS Code
从 Visual Studio Marketplace 安装 **Azure MCP** 扩展：
👉 [Azure MCP 扩展](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-azure-mcp-server)
Azure MCP 扩展还将安装一个配套扩展，将 Azure skills 引入 VS Code。它们会共同自动配置 Azure MCP Server、Foundry MCP 和完整的 skills 层。
### Claude Code
**安装插件** — 运行：
```
/plugin install azure@claude-plugins-official
```
或者运行 `/plugin` 并在市场中搜索 “azure”：
**更新插件**：
```
/plugin update azure@claude-plugins-official
```
### Gemini CLI
**安装扩展**：
```
gemini extensions install https://github.com/microsoft/azure-skills
```
### Cursor
您可以从 [Cursor Marketplace](https://cursor.com/marketplace/azure) 安装 Azure 插件，或者直接在 Cursor 设置中导航至 **Settings** > **Plugins** 并搜索 “Azure”：
### Codex CLI
**添加市场**（仅限首次）：
```
codex plugin marketplace add microsoft/azure-skills
```
**安装插件**：
使用 `/plugins` 浏览插件并安装 `azure`：
**启用或禁用 skills**：
您可以通过在 Codex 中运行 `/skills` 并选择适当的选项，来选择启用或禁用特定的 skills：
### IntelliJ IDEA
#### 前置条件
在 IntelliJ IDEA 中安装 Azure skills 之前，请确保您具备：
- 系统上安装了 **Node.js 18+**，并且 PATH 中有可用的 `npx`
- 已安装 **Git** 并且可以从命令行访问
您可以通过运行以下命令来验证这些前提条件：
```
npx --version
git --version
```
#### 第 1 步：安装 GitHub Copilot 插件
1. 打开 IntelliJ IDEA
2. 转到 **File** > **Settings**（在 Windows/Linux 上）或 **IntelliJ IDEA** > **Preferences**（在 macOS 上）
3. 在左侧边栏中导航至 **Plugins**
4. 在 Marketplace 选项卡中搜索 “GitHub Copilot”
5. 安装 [GitHub Copilot 插件](https://plugins.jetbrains.com/plugin/17718-github-copilot--your-ai-pair-programmer)（要求版本 1.5.64-242 或更高）
6. 出现提示时重启 IntelliJ IDEA
#### 第 2 步：为 GitHub Copilot 启用 Skills
1. 再次打开 IntelliJ IDEA 设置/首选项
2. 导航至 **Tools** > **GitHub Copilot** > **Chat**
3. 勾选 **“Enable Skills”** 复选框
4. 点击 **Apply** 和 **OK**
#### 第 3 步：安装 Azure Skills
**选项 1：安装 Azure Toolkit For IntelliJ 插件**
1. 从 JetBrains Marketplace **安装 Azure Toolkit 插件**：
👉 [Azure Toolkit for IntelliJ](https://plugins.jetbrains.com/plugin/8053-azure-toolkit-for-intellij)
2. **重启 IntelliJ IDEA** 以完成插件安装
3. 出现提示时，**安装 Azure Skills**：
- 重启后，您会看到一条提供安装 Azure Skills 的通知
- 点击 **Install** 将 Azure skills 添加到您的环境中
- 请参阅下方的截图作为参考
4. 通过打开 GitHub Copilot 聊天窗口并输入以下内容来**验证安装**：
/skill:azure
这将显示您现在可以在项目中使用的所有可用 Azure skills。
**选项 2：** 手动安装 Azure Skills
1. 打开终端或命令提示符
2. 运行以下命令为 GitHub Copilot 全局安装 Azure skills：
npx skills add https://github.com/microsoft/azure-skills/tree/main/.github/plugins/azure-skills/skills -a github-copilot -g -y
**命令解释：**
- `npx skills add` - 使用 skills CLI 添加新的 skills 包
- GitHub URL 指向此仓库中的 Azure skills 目录
- `-a github-copilot` - 指定 skills 用于 GitHub Copilot
- `-g` - 全局安装 skills（在所有项目中可用）
- `-y` - 在安装过程中自动接受提示
3. 等待安装完成。您应该会看到 Azure skills 已成功添加的确认信息。
## 主权云配置
默认情况下，Azure MCP server 会连接到 Azure 公有云。如果您使用的是主权云（Azure 中国云或 Azure 美国政府云），您需要配置 MCP server 以使用适当的云环境。
### Copilot CLI
安装插件后，也应为 copilot 配置 Azure MCP server。您可以通过运行 `/mcp show` 来列出已配置的 MCP 服务器
编辑来自 `plugin:azure` 的名为 `azure` 的 Azure MCP server，以添加 `--cloud` 参数。执行 `/mcp edit azure`。导航到 `Command` 部分添加 `--cloud` 参数，使用 `AzureChinaCloud` 访问 Azure 中国云，使用 `AzureUSGovernment` 访问 Azure 美国政府云。
在启动 MCP server 之前，请确保您的本地 CLI 工具已针对正确的云进行了身份验证：
| 云 | Azure CLI | Azure PowerShell | Azure Developer CLI |
|-------|-----------|-----------------|---------------------|
| 中国 | `az cloud set --name AzureChinaCloud && az login` | `Connect-AzAccount -Environment AzureChinaCloud` | `azd config set cloud.name AzureChinaCloud && azd auth login` |
| 美国政府 | `az cloud set --name AzureUSGovernment && az login` | `Connect-AzAccount -Environment AzureUSGovernment` | `azd config set cloud.name AzureUSGovernment && azd auth login` |
有关更多详细信息，请参阅 Azure MCP Server 文档中的[连接到主权云](https://learn.microsoft.com/azure/developer/azure-mcp-server/how-to/connect-sovereign-clouds)。
## 验证安装
安装后，尝试进行三个快速检查。
### 1. 验证 skills 层
询问：
您应该获得结构化的 Azure 指导，而不仅仅是通用的云解答。
### 2. 验证 Azure MCP
询问：
您应该看到来自您 Azure 账户的真实的工具支持响应。
### 3. 验证 Foundry MCP
询问：
您应该获得 Foundry 支持的响应，而不是通用的摘要。
## 身份验证
推荐的身份验证路径是 Azure CLI：
```
az login
```
如果您计划使用 `azd` 进行部署，请同时运行：
```
azd auth login
```
您也可以使用服务主体凭据进行身份验证：
**Bash/Zsh**
```
export AZURE_TENANT_ID="your-tenant-id"
export AZURE_CLIENT_ID="your-client-id"
export AZURE_CLIENT_SECRET="your-client-secret"
```
**PowerShell**
```
$env:AZURE_TENANT_ID = "your-tenant-id"
$env:AZURE_CLIENT_ID = "your-client-id"
$env:AZURE_CLIENT_SECRET = "your-client-secret"
```
当代理在 Azure 中运行时，Azure MCP Server 也可以使用托管标识。
## 尝试提示词
安装插件后，可以尝试如下提示词：
- `Prepare this app for Azure.`
- `Validate my Azure deployment files before I run azd up.`
- `Deploy this project to Azure Container Apps.`
- `List my Azure storage accounts.`
- `Find cost savings across my Azure subscription.`
- `Troubleshoot why my container app is failing health probes.`
- `What role should I assign to let this managed identity read blobs?`
- `What AI models are available in Microsoft Foundry?`
## 仓库布局
如果您正在探索或自定义插件源代码，关键部分如下：
- `.github/plugins/azure-skills/skills/` - Azure skill 定义
- `.github/plugins/azure-skills/.mcp.json` - 包含的 Azure 和 Foundry 的 MCP 配置
- `landing-page/` - Astro GitHub Pages 站点源码和维护指南
- `README.md` - 插件的高级概述和安装指南
## 故障排除
### 代理未使用 Azure skills
- 确保插件已在您的主机中成功安装
- 确认 Azure skills 目录存在
- 重新加载或重启您的主机，以便它重新索引插件和 MCP 配置
### MCP 工具未显示
- 验证已安装 Node.js 并且 `npx` 可正常工作
- 检查是否为您的主机添加了 Azure 和 Foundry MCP 条目
- 在配置更改后重启 MCP 服务器或重新加载主机
### Azure 命令因身份验证错误而失败
- 重新运行 `az login`
- 对于部署场景，重新运行 `azd auth login`
- 确保选择了正确的 Azure 订阅
## 了解更多
- [Azure MCP Server 文档](https://learn.microsoft.com/azure/developer/azure-mcp-server/)
- [Azure 文档](_URL_10/>)
- [Azure CLI 参考](https://learn.microsoft.com/cli/azure/)
## 遥测
要禁用 Azure MCP 遥测收集，请设置：
```
export AZURE_MCP_COLLECT_TELEMETRY=false
```
## 贡献
此仓库会自动从 https://github.com/microsoft/GitHub-Copilot-for-Azure 同步。如果您想为 Azure skills 做出贡献，请在此处提交 PR。谢谢！
标签：AI代理, Azure, MCP, MITM代理, SOC Prime, 开发工具