Azure Agent Skills 是 Microsoft 第一方提供并由 Microsoft 编写的、用于 Azure 开发的 AI 可读技能目录。 每个技能都是权威 Microsoft Learn 内容的结构化索引，这些内容经过整理，使 AI 编码助手能够发现并使用，以提供有关 Azure 服务的准确和最新指南。
技能遵循 Agent Skills 开放标准并处理任何兼容的 AI 编码助手，包括 GitHub Copilot、Claude Code、Cursor、Gemini CLI、Codex CLI 等。
用例
- 为AI编程助手提供基于官方文档的专家级指导
- 提高Azure开发任务的代理响应的准确性和完整性
- 使开发人员能够在编辑器中直接获取最佳做法、故障排除流、体系结构模式和安全指南
- 提供结构化的最新知识，以补充 MCP 服务器等实时数据工具。
代理技能的工作原理
代理技能是基于文件系统的轻型功能模块。 每个技能都是一个 文件夹，其中包含 YAML frontmatter（名称、说明、兼容性）和按类别组织的结构化内容（故障排除、最佳做法、体系结构、安全、配置等）。
技能通过渐进式披露来高效加载内容：
- 发现（Discovery）——AI 助手从 YAML frontmatter 中读取技能的 和 ，以确定其相关性
- 说明 - 触发时，助手将加载完整 内容，其中包含按主题组织的特选文档链接
- 提取 - 助手使用 Learn MCP 服务器 或 Web 提取工具从 Microsoft Learn 检索最新内容
此体系结构将 知识索引 （要查找的内容和时间）与 内容交付 （在查询时提取最新文档）分开，确保随着文档的发展，技能保持最新状态。
技能目录由用于扫描Azure产品文档、识别高价值过程和决策内容的专用管道自动生成和维护，并将其转换为结构化技能文件。 管道持续评估上游内容更改并生成增量更新。
技能目录
库包含 193 项技能，涵盖这些类别：Azure 的核心服务。
| 类别 | 技能 | 例子 |
|---|---|---|
| 基础结构和管理 | 二十七 | Azure 资源管理器， 备份， 监视器， 策略， 成本管理， Arc |
| 专用 | 二十七 | 量子（Quantum）、地图（Maps）、VMware 解决方案、SAP、健康数据服务、虚拟桌面 |
| 网络 | 24 | 虚拟网络、Front Door、防火墙、VPN 网关、ExpressRoute、负载均衡器 |
| AI 和 ML | 20 | AI服务、机器学习、文档智能、语音、机器人服务 |
| 数据和分析 | 20 | Cosmos DB、SQL 数据库、数据工厂、Synapse Analytics、Databricks |
| 安全性与标识 | 17 | 密钥保管库、RBAC、Sentinel、Defender for Cloud、机密计算 |
| DevOps | 14 | Azure DevOps、管道、容器注册表、部署环境、开发框 |
| 计算 | 13 | Functions、容器应用、虚拟机、Kubernetes 服务、应用服务 |
| 整合 | 12 | 逻辑应用、API 管理、事件网格、服务总线、事件中心 |
| 存储 | 9 | Blob 存储、文件、弹性 SAN、NetApp 文件、容器存储 |
| IoT 和 Edge | 7 | IoT 中心、IoT Central、IoT Edge、IoT运营、数字孪生 |
基于角色 的特选捆绑包 适用于常见方案（Essentials、Infrastructure、Data Engineering、AI/ML、Security、DevOps）。
文档 /CATALOG.md 中提供了完整的技能目录。
要求
- 需要网络访问。 技能引用 Microsoft Learn 文档的 URL，这些 URL 是 AI 助手在查询时提取的。
- 支持代理技能开放标准（格式）的兼容 AI 编码助手。
- 建议使用 Microsoft Learn MCP 服务器，以获得最佳文档检索效果。 如果 Learn MCP Server 不可用，技能会回退到大多数 AI 助手内置的网页获取能力。
无需身份验证即可自行使用技能。 这些技能是静态文件，在开发环境中本地运行。
入门指南
安装
克隆存储库：
git clone https://github.com/MicrosoftDocs/agent-skills.git将技能文件夹从 AI 助手的技能目录复制到：
AI 助手 项目级路径 全局路径 GitHub Copilot {project}/.github/skills/~/.copilot/skills/Claude Code {project}/.claude/skills/~/.claude/skills/Codex CLI {project}/.codex/skills/~/.codex/skills/Cursor {project}/.cursor/skills/— Gemini CLI {project}/.gemini/skills/— 重要
复制 文件夹内部 （例如， ）， 而不是 文件夹本身。
VS Code 用户：启用 聊天：在“设置”中使用代理技能 （）。
开始询问 AI 助手 Azure 的问题。 技能会根据查询自动激活。
用法
安装后，自然地向 AI 助手提问：
- “帮我使用 Durable Functions 设置 Azure Functions”
- “Azure 容器应用的最佳做法是什么？”
- “我的存储帐户出现了限流错误——应该如何诊断？”
助手将自动发现相关技能，加载结构化指南，并从Microsoft学习中提取最新文档，以提供准确的、有底底的答案。
兼容性
这些技能适用于支持 代理技能规范的任何 AI 编码助手：
| AI 编码助手 | 类型 | 技能路径 |
|---|---|---|
| GitHub Copilot | VS Code 扩展 | .github/skills/ |
| Claude Code | Anthropic CLI | .claude/skills/ |
| Codex CLI | OpenAI CLI | .codex/skills/ |
| Cursor | AI 原生 IDE | .cursor/skills/ |
| Gemini CLI | Google DeepMind | .gemini/skills/ |
| 反重力 IDE | DeepMind IDE | .agent/skills/ |
| OpenCode | 开源 CLI | .agent/skills/ |
与 Learn MCP 服务器的关系
代理技能和 Learn MCP 服务器 是互补的：
- Learn MCP 服务器 提供 工具 - 针对 Microsoft Learn 内容进行搜索、提取和代码示例检索
- 代理人的技能提供了关于知识的结构化指导，说明要查找什么内容，何时查找以及如何应用该知识。
技能使用 Learn MCP 服务器（或等效的提取功能）作为其内容传送机制。 它们共同为 AI 助手提供判断，以确定相关内容以及检索最新权威内容的能力。
可用性和定价
Azure代理技能在双重许可证下作为开源存储库公开提供：
- 文档内容：知识共享署名 4.0 国际许可协议
- 代码： MIT 许可证
使用技能不收取任何费用。
局限性
- 技能需要网络访问权限才能从 Microsoft Learn 中提取文档。 如果没有网络访问，技能可提供特选的链接索引，但无法检索完整内容。
- 技能目录目前涵盖 193 个Azure服务。 随着每次管道运行发布新的文档，覆盖范围也在不断扩大。
- 技能是从公开提供的Microsoft Learn 文档生成的。 目前不包括培训模块、学习路径和讲师引导课程中的内容。
- 生成管道以增量方式运行。 Microsoft Learn 的文档更新和相应的技能更新之间可能存在短暂的延迟。
如何提供反馈
- GitHub问题：https://github.com/MicrosoftDocs/agent-skills/issues（建议用于提交bug、缺陷或功能请求）
- 贡献：存储库欢迎拉取请求。 请参阅README中的贡献指南。
后续步骤
- 请在 VS Code 中开始使用 Learn MCP 服务器
- 代理技能开放标准规范
- Azure代理技能存储库
- 基于角色的精心策划技能包