Azure Agent Skills（微软官方 Azure 技能库）
为 Claude Code、GitHub Copilot、Cursor 等 AI 编码助手提供基于 Microsoft Learn 文档预编译的结构化 Azure 专业知识，按需加载、即装即用。
最小权限：仓库展示的内容为 Markdown 技能与插件清单，未发现可执行脚本或破坏性操作，但技能声明需要网络访问以抓取 Microsoft Learn 文档，扣 1 分（抓取范围未界定）。用户确认：无任何关于在执行操作前征求用户确认的指引。数据流透明：明确说明技能通过 MCP（mcp_microsoftdocs）或 fetch_webpage 拉取 Learn 内容，流向清楚，但未说明缓存/日志行为，扣 1 分。敏感数据：完全未提及对密钥、连接串等敏感信息的处理指引，扣分。依赖安全：无可执行依赖，仅依赖宿主助手的 fetch/MCP 工具，风险低但未提供任何供应链说明。外部影响：技能本质是文档指引，无直接外部副作用。回滚：手动安装可删除文件夹、插件可卸载，README 提到可删除克隆仓库，基本可用但无版本锁定/降级说明。来源归属：所有技能明确指向 Microsoft Learn 官方文档链接，归属处理到位。
自一致性：README 各处（技能总数、路径表、插件清单路径）内部一致，但仅凭 README 无法核对 193 个技能文件的实际一致性，扣 1 分。依赖可用性：强烈依赖外部 Microsoft Learn MCP 服务器与网络抓取工具，若不可用则技能价值大打折扣，且未提供降级路径。失败信息：未描述抓取失败、文档链接失效或 MCP 不可用时的处理策略，扣分明显。
受众与场景：角色化 bundle（Quick Start、Data Engineer 等）和多助手路径表显示对受众考虑充分，但仅凭 README 无法验证技能本身对场景的覆盖。能力边界：未明确说明技能不能做什么（如不执行 Azure CLI、不修改资源），扣分。触发精度：依赖 YAML frontmatter description 触发，但本次证据未包含任何 SKILL.md，无法验证 description 质量。环境适配：8 个助手的路径/启用方式（含 VS Code chat.agent.skills 实验开关）说明详尽，接近满分。
信息架构：按 Azure 服务域分类、目录职责表（skills/、products/、插件清单）清晰。安装说明：一页覆盖插件一键安装、手动复制（含常见错误示例）、实验开关，堪称典范。命名稳定性：技能名命名规范有描述（小写连字符），但 weekly crawl 可能引起技能增减/重命名，无稳定性承诺。示例与 FAQ：有使用示例和路径注意事项，但无正式 FAQ。已知限制：标注了 VS Code 预览特性、实验性开关、贡献政策限制，尚可。许可：CC-BY-4.0（文档）+ MIT（代码）双许可，LICENSE 全文在列。版本与变更日志：未见 CHANGELOG 或技能版本号，插件更新机制描述含糊，扣分。维护责任：声明自动每周抓取、不接受手动技能贡献、MSRC 报告渠道，责任路径清楚但具体维护者/SLA 未列。
输出可用性：技能输出为文档链接 + 最佳实践 + 架构模式，结构明确，但无法静态验证单个 SKILL.md 的实际输出质量。边际价值：将 Learn 文档预编译为结构化技能、避免每次 RAG，价值主张成立，但其内容本质是公开文档的重组，扣 1 分。成本收益：渐进式披露设计控制 token 成本，但要求网络抓取完整文档页，大型查询的 token 开销未讨论。
主张可追溯：技能声称内容源自 Microsoft Learn 并提供链接，可追溯性设计良好，但链接未在本证据中逐一核对。跨源印证：指向官方 Learn/Well-Architected 等权威源，可印证性中等，实际内容未随附。事实与推断分离：本次证据未包含 SKILL.md 内容，无法验证技能是否区分来自文档的事实与作者推断，扣 2 分，此为本次评审最大空白。
- 所有技能依赖 Microsoft Learn MCP 服务器或网络抓取工具；这些工具不可用时技能将失效，且仓库未定义降级行为。
- 抓取的外部网页内容会直接进入助手上下文，存在提示注入风险；仓库未提供任何敏感数据处理或注入防护指引。
- 发布者身份未经 FollowAgents 企业注册表验证，请在企业环境部署前自行确认来源与内容。
- 技能由每周自动抓取生成，可能随时增删或变动，不适合对技能集稳定性有严格要求的场景；未提供版本锁定或变更日志。
- 本评审为静态源码评审，未执行任何技能；单个 SKILL.md 的内容质量与事实/推断区分无法验证。
这个 Agent 能做什么，适合哪些场景？
这是微软 MicrosoftDocs 组织维护的开源仓库，收录 193 个遵循 Agent Skills 开放标准（SKILL.md 格式）的 Azure 技能，覆盖计算、数据、AI/ML、网络、安全、基础设施等 19 个类别。技能不是独立运行的程序，而是由 AI 编码助手按需加载的 Markdown 指令与资源，通过三级渐进式披露（发现→指令→资源）只在相关时才载入内容。仓库同时提供 VS Code、Claude Code 和 OpenAI Codex 的原生插件清单，可一键安装全部技能。技能依赖网络访问，通过 Microsoft Learn MCP Server 或网页抓取工具实时获取最新官方文档。文档内容采用 CC BY 4.0 许可，代码采用 MIT 许可；不接受手动创建或编辑技能的贡献，需通过 Microsoft Learn 文档更新加每周自动爬取来更新。
仓库将 Microsoft Learn 文档中的决策、流程、最佳实践和约束预编译为结构化技能：每个技能是一个含 YAML frontmatter（name、description）的 SKILL.md 文件夹，附带文档链接、最佳实践、架构模式和排障指南。安装后，AI 助手先从 frontmatter 发现技能，被触发时加载完整指令，再按需访问脚本与示例等资源。使用时助手可经 mcp_microsoftdocs:microsoft_docs_fetch（Microsoft Learn MCP Server）或 fetch_webpage 工具拉取最新文档内容，从而回答如“如何在 Azure Container Apps 中实现蓝绿部署”这类问题。skills/ 目录存放生产就绪技能，plugin.、.claude-plugin/、.codex-plugin/ 等提供各平台的插件清单，products/ 目录用于内部扫描管线数据。
- Azure 开发者使用 Claude Code 或 Copilot 编码时，希望助手自动掌握 Functions、Container Apps 等服务的官方最佳实践，而不必在对话中反复粘贴文档
- AI/ML 工程师按 AI/ML Developer 捆绑包快速安装 Azure AI Services、Microsoft Foundry 等相关技能集
- 基础设施工程师使用 Infrastructure Pro 捆绑包，为网络、备份、恢复和资源管理获取架构与配置指导
- 安全合规团队加载 Security & Compliance 捆绑包，获得 RBAC、策略、密钥管理和合规方面的技能
- 团队希望以插件方式统一管理技能更新，在 VS Code 中通过 chat.plugins.marketplaces 配置自动获取每周从 Learn 文档爬取的最新版本
- 使用 Cursor、Gemini CLI、OpenCode 或 AdaL CLI 的用户将 skills/ 目录复制到对应路径（如 .cursor/skills/）后以自然语言或 @skill-name 调用
这个 Agent 有哪些优点和局限？
- 内容由 Microsoft Learn 官方文档预编译而成，并每周自动重新爬取，保证与官方最佳实践同步
- 一个仓库同时提供 VS Code、Claude Code、Codex 的原生插件清单，一次安装覆盖所有 193+ 技能并自带更新
- 兼容 Claude Code、Gemini CLI、Codex CLI、Antigravity、GitHub Copilot、Cursor、OpenCode、AdaL CLI 等主流助手，遵循 agentskills.io 开放标准
- 三级渐进式披露按需加载，不占用无关上下文
- 提供 Quick Start、Popular、AI/ML Developer 等十种角色化捆绑包，降低起步成本
- 多数技能需网络访问 Microsoft Learn（MCP Server 或网页抓取），离线环境基本不可用
- 不接受手动创建或编辑技能的贡献，技能内容变更需先修改 Learn 文档再请求重爬或等每周爬取
- VS Code 的 agent 插件与 Agent Skills 均为预览/实验性功能，需手动启用 chat.plugins.enabled 和 chat.agent.skills，且可能受组织策略限制
- 技能是文档型指令而非可执行代码，质量取决于助手对 SKILL.md 的解释与实时抓取能力
- 仅覆盖 Microsoft/Azure 生态，对非 Azure 技术栈没有价值；目录复制方式无自动更新，需手动重新拉取
如何安装或部署这个 Agent？
推荐插件安装：
- VS Code：命令面板 → “Chat: Install Plugin From Source” → 粘贴 https://github.com/MicrosoftDocs/agent-skills；或先在 settings. 中将 "MicrosoftDocs/agent-skills" 加入 chat.plugins.marketplaces，再在扩展视图 @agentPlugins 安装 azure-agent-skills（需启用 chat.plugins.enabled 预览功能）。
- Claude Code：运行 /plugin marketplace add MicrosoftDocs/agent-skills，再运行 /plugin install azure-agent-skills@microsoft-agent-skills，最后 /reload-plugins。
- Codex：运行 codex plugin marketplace add MicrosoftDocs/agent-skills，在 /plugins 浏览器中安装 azure-agent-skills。
手动安装：git clone https://github.com/MicrosoftDocs/agent-skills.git，然后把 skills/ 文件夹内的内容（如 azure-functions/）复制到对应路径——Copilot 为 .github/skills/ 或 ~/.copilot/skills/，Claude Code 为 .claude/skills/ 或 ~/.claude/skills/，Codex 为 .codex/skills/，Cursor 为 .cursor/skills/，Gemini CLI 为 .gemini/skills/，OpenCode 为 .agent/skills/。VS Code 手动方式还须在设置中勾选 “Chat: Use Agent Skills”（chat.agent.skills）。注意复制的是 skills/ 内部的文件夹而非 skills/ 本身。
如何使用这个 Agent？
确保 AI 助手可访问网络（多数技能需要联网获取 Microsoft Learn 最新文档，推荐配置 Microsoft Learn MCP Server 的 mcp_microsoftdocs:microsoft_docs_fetch，或具备 fetch_webpage 网页抓取工具）。安装后直接用自然语言提问，例如：“帮我用 Durable Functions 搭建 Azure Functions”“Azure Container Apps 有哪些最佳实践”“如何配置 Azure API Management”。助手会自动发现相关技能，按渐进式披露加载指令并实时抓取官方文档给出答案。Claude Code 支持 /skill-name 调用，Cursor 用 @skill-name，OpenCode 用 opencode run @skill-name，Copilot 支持 @workspace。可先参考 docs/BUNDLES.md 选择 Quick Start、Popular 等角色化捆绑包。
这个 Agent 与同类方案有什么区别？
README 将其与 anthropics/skills（Anthropic 官方文档处理技能）、openai/skills（Codex 技能目录）和 github/awesome-copilot（Copilot 社区合集）并列为技能仓库示例；与这些通用技能库不同，本仓库专精于 Azure 云服务领域知识。