如何让 AI 助手像解决方案架构师一样理解 Azure
最近我突然意识到：我们已经习惯了 GitHub Copilot 或 Claude Code 几乎无所不知，但一旦涉及云服务的细节，幻觉就开始出现了。神经网络可能会给你一个大约三年前就已经过时的 Azure Functions 配置，或者建议一个违反内置订阅限制的架构。问题在于模型的知识仅限于其训练时刻，而微软学习文档几乎每天都在变化。
我偶然发现了微软团队推出的 Agent-Skills 仓库。理念很简单但非常实用：不是让 AI「记住」文档，而是向其提供结构化的技能。这就像是给代理的一个参考指南，直接集成在你的项目中，告诉它：「在处理 Azure 时，看这里，使用这些模式，别忘了这些限制。」
这到底是什么
该项目是一个庞大的目录，包含了近两百个用于处理 Azure 的现成技能。这些不仅仅是文档链接。每个技能都是一组 Markdown 格式的指令，AI 助手在向你建议代码之前会先读取这些指令。
微软的开发者采用了「文档即代码」的方式。他们从微软学习（Microsoft Learn）中获取了大量内容——最佳实践、决策树、常见错误和安全要求——并将其打包成 LLM 友好的指令。结果是，代理不仅仅是在写代码，它还理解特定服务的上下文。
为什么要费力将其添加到项目中
如果你使用 Azure，就会知道其中有多少细微差别。例如，你可以通过十几种方式配置 Azure 容器应用，但只有少数几种能满足企业级标准。
这些技能在实践中能给你带来以下好处：
- 代理不再猜测，而是开始使用当前的 API 模式。
- 响应中包含指向相关微软学习章节的直接链接。
- AI 开始在部署错误配置之前就警告你有关限制和配置细节。
- 代理获得了现成的故障排除清单。
内部工作原理
其核心是一个开放的 Agent Skills 标准。每个技能都位于 skills/ 目录中各自的文件夹内。SKILL.md 文件结构大致如下：
---
name: azure-functions
description: Инструкции по разработке и развертыванию Azure Functions
---
# Azure Functions
## Инструкции
[Тут идут конкретные шаги для агента]
## Примеры
[Примеры правильного использования сервиса]
有趣的是，该系统采用渐进式披露原则。首先，代理只在 YAML 头信息中看到名称和简要描述。如果你的请求与该技能的主题匹配，代理会「展开」完整指令并开始按照它行动。这节省了模型的上下文窗口，不会用不必要的内容使其杂乱无章。
如何启动这个功能
最简单的方式是将其作为插件安装。对于 VS Code，你可以通过命令面板完成：选择Chat: Install Plugin From Source并粘贴仓库链接 https://github.com/MicrosoftDocs/agent-skills。
如果你更喜欢完全控制或使用 Cursor，可以简单地克隆仓库并将 skills/ 中需要的文件夹复制到你的项目目录。每种工具的路径各不相同：
- GitHub Copilot：
.github/skills/ - Cursor：
.cursor/skills/ - Claude Code：
.claude/skills/
顺便说一句，对于 VS Code，你需要记住启用 chat.agent.skills 设置，否则魔法不会发生。
实际好处和分类
该仓库目前有 193 个技能。它们按类别分类，所以你不必全部携带——你可以只选择特定技术栈所需的内容：
- 计算（13 个技能）：应用服务、函数、批处理。
- AI 和机器学习（23 个技能）：关于 Azure AI 服务和机器人的一切。
- 安全（19 个技能）：Active Directory、Key Vault 等。
- 基础设施（52 个技能）：这是重量级内容——AKS、Arc 和网络配置。
如果你不知道从哪里开始，docs/BUNDLES.md 文件夹中有精选的集合。例如，「快速入门」捆绑包包含 7 项基本服务，对任何 Azure 开发者都有用。
值得一试吗
这个项目看起来是让 AI 助手「扎根」于真实任务的好方法。与其每次都将文档片段复制粘贴到 Copilot 聊天中，不如一次性连接仓库，获得一个了解微软生态系统规则的称职助手。
对于刚刚迁移到 Azure 或开始使用 Durable Functions 或 Azure API 管理等复杂服务的团队来说，这将特别有用。这些服务很容易配置错误，之后修复既耗时又昂贵。
唯一的缺点是该项目仍处于预览阶段，某些功能需要在 IDE 中启用实验性标志。但即使在手动模式下，将需要的 .md 文件复制到你的项目中也能显著提升代码生成质量。如果你大量使用 Azure，这个仓库绝对值得收藏。
相关项目