项目介绍
Azure Agent Skills 是 MicrosoftDocs 维护的 Azure 开发 Skill 合集。它把 Microsoft Learn 中的服务配置、架构选择、安全约束、限制配额、故障排查和部署步骤整理成符合 Agent Skills 约定的 SKILL.md,让 Codex、Claude Code、GitHub Copilot 等助手在相关任务中按需加载。仓库提供整包插件安装和手动复制两条路径,但它不是 Azure 管理工具;当任务需要最新文档时,多数 Skills 还会联网访问 Microsoft Learn。
核心功能
Azure 服务知识索引
以服务为单位组织配置、决策、安全、限制、集成、部署和故障排查条目,并链接到对应 Microsoft Learn 页面。
渐进披露
宿主先读取 Skill 名称和描述,任务匹配后再加载完整 SKILL.md,必要时读取引用文件或远程文档,避免每次会话一次性载入整个合集。
多宿主插件分发
仓库同时包含通用 plugin.json、Claude Code 清单、Codex 插件清单和 Codex Marketplace 目录,可用一套来源安装到多个宿主。
角色型 Bundles
文档按快速开始、AI/ML、数据工程、基础设施、安全合规、DevOps、集成和全栈 Azure 等场景给出建议 Skill 组合。
文档更新提示
生成的 Skill 记录生成日期;代表性文件要求超过三个月时建议拉取最新版,并优先使用 Microsoft Learn MCP 获取正文。
安装与使用
Codex 推荐使用仓库自带 Marketplace 清单安装整包。安装前先确认宿主支持插件市场、写入范围和网络策略;若只需少数服务,可克隆后只复制对应 skills/ 子目录。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请从 https://github.com/MicrosoftDocs/Agent-Skills 安装 Azure Agent Skills。先阅读 README.md、LICENSE、LICENSE-CODE、SECURITY.md、.codex-plugin/plugin.json 和 .agents/plugins/marketplace.json,确认插件名是 azure-agent-skills、清单版本是 1.0.0,并说明将写入的 Codex 插件范围。未经我确认不要安装,不要请求或写入 Azure 凭据。确认后执行 README 提供的 `codex plugin marketplace add MicrosoftDocs/agent-skills`,再通过 `/plugins` 安装 azure-agent-skills。安装后只用一个不改代码、不访问 Azure 订阅的只读问题验证 Skill 发现;列出新增文件或配置。若需要用户主目录写入、组织策略变更、额外网络连接、Microsoft Learn MCP、Azure 登录或云资源修改,先停下并询问。- 支持插件市场的 Codex,或支持 SKILL.md 的兼容宿主
- 访问公开 GitHub 仓库的网络权限
- 插件或 Skills 目标目录写权限
- 需要读取最新正文时可访问 Microsoft Learn MCP 或网页
项目地址:https://github.com/MicrosoftDocs/Agent-Skills
复制地址并按照下方步骤完成设置。- 1确认宿主与权限范围
确认 Codex 支持插件市场,并检查是否允许访问 GitHub、写入插件目录。此时不要配置 Azure 凭据。
- 2添加官方仓库 Marketplace
在 Codex CLI 运行 `codex plugin marketplace add MicrosoftDocs/agent-skills`,来源应保持为 MicrosoftDocs/Agent-Skills。
- 3安装 Azure Agent Skills
打开 `/plugins`,在 microsoft-agent-skills Marketplace 中选择 azure-agent-skills;若未立即出现,按 README 建议重启 Codex。
- 4做只读发现验证
询问一个具体 Azure 服务的架构或限制问题,确认相应 Skill 被发现;不要在首个验证任务中修改代码、登录 Azure 或创建资源。
- 5按任务开放外部访问
需要最新正文时再允许 Microsoft Learn MCP 或网页访问;需要实际 Azure 操作时,单独审查工具、身份、订阅、资源组和可写范围。
安装后在宿主中确认 azure-agent-skills 已启用,并检查至少一个目标 Skill(例如 azure-functions)的名称、描述、生成日期与网络要求。先提出一个只读问题,例如比较 Azure Functions 托管方案,不授予 Azure 凭据、不修改项目或云资源;确认回答引用了相关 Skill 后,再决定是否为后续操作开放额外权限。
- README 将插件方式列为推荐路径,Codex 需要先添加 Marketplace,再在 /plugins 中选择 azure-agent-skills。
- 手动安装时应复制 skills/ 中的内容,而不是把整个仓库根目录当成单个 Skill。
- VS Code 的插件市场方式仍是预览功能,需要 chat.plugins.enabled=true,组织可能锁定该设置。
- 仓库没有 GitHub Release 或 Tag;更新前应检查 main 分支提交和清单版本。

使用场景
Azure 架构与服务选型
比较托管、伸缩、网络和集成方案,让 Agent 从结构化索引定位相关 Microsoft Learn 证据。
配置与故障排查
按错误类型、配置项或服务限制定位排查文档,适合 Functions、Key Vault、网络、数据与 AI 服务。
安全与权限审查
检索 RBAC、私有端点、密钥管理、加密、零信任与服务特定安全约束,再由团队完成最终审查。
部署与迁移规划
获取 IaC、CI/CD、运行时升级、托管计划和跨平台迁移的官方文档入口与操作次序。
使用评价
这套资源的价值不在于数量或 Stars,而在于来源身份、可检查的 Skill 目录、原生宿主清单和对 Microsoft Learn 的细粒度索引。代表性 Skill 同时覆盖决策、限制、安全、配置、集成与部署,并明确网络依赖和内容更新时间。主要边界是:它是生成型指导层而非 Azure 控制平面;多数正文仍需联网获取,且没有 Release/Tag 可用于固定升级节点。本次只完成仓库与内容证据核验,没有安装、联网抓取 Learn 正文或执行 Azure 操作。
值得一试的地方
- MicrosoftDocs 身份与双许可证清晰
- 实际 Skill、插件清单和安装证据完整
- 覆盖 Azure 服务决策、安全、限制和故障排查
- 多宿主安装与手动选择单个 Skill 均有路径
- 近期仍有自动生成更新和明确安全披露渠道
使用前要知道
- 多数 Skill 依赖外部 Microsoft Learn 访问
- 没有 Release 或 Tag 作为稳定更新节点
- README 数量与实际目录数存在口径差异
- 未执行安装、兼容性或 Azure 功能测试
README
Azure Agent Skills
Overview
MicrosoftDocs 维护的 Azure Agent Skills 合集,以标准 SKILL.md 形式把 Microsoft Learn 中的决策、配置、安全、故障排查与部署知识提供给 Codex、Claude Code、GitHub Copilot 等 AI 编程助手。 为 Microsoft 与 Azure 提供经过整理的 Agent Skills,让 AI 编程助手获得来自 Microsoft Learn 的结构化、实时专业知识。
Getting started
- Codex 推荐使用仓库自带 Marketplace 清单安装整包。安装前先确认宿主支持插件市场、写入范围和网络策略;若只需少数服务,可克隆后只复制对应 skills/ 子目录。
- README 将 Microsoft Learn 中的决策、程序、最佳实践和约束预编译为可按需发现、加载和继续读取资源的 Skills。
- 插件路线可一次安装全部 193+ Skills:VS Code 从源码或 Marketplace 安装,Claude Code 与 Codex 使用各自插件市场。其他宿主可克隆仓库后复制 skills/ 内容。
- 安装后在宿主中确认 azure-agent-skills 已启用,并检查至少一个目标 Skill(例如 azure-functions)的名称、描述、生成日期与网络要求。先提出一个只读问题,例如比较 Azure Functions 托管方案,不授予 Azure 凭据、不修改项目或云资源;确认回答引用了相关 Skill 后,再决定是否为后续操作开放额外权限。
Configuration
项目地址:https://github.com/MicrosoftDocs/Agent-Skills
复制地址并按照下方步骤完成设置。在 GitHub 阅读完整 README →