1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | microsoft-foundry-MicrosoftDocs-Agent-Skills |
| 项目自述名称 | Microsoft Foundry Skill |
| 作者/维护者 | Microsoft（MicrosoftDocs 官方仓库） |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/microsoft-foundry |
| 许可证 | 内容 CC BY 4.0 + 代码 MIT（数据来自仓库 LICENSE / LICENSE-CODE 文件） |
| GitHub Stars | 723★（数据来自 GitHub API；为合集仓库整体数字，仓库下共 200+ 个子技能，不代表本技能自身热度） |
| Forks | 117（同上，合集整体数字） |
| 最新版本 | 无独立版本号，SKILL.md 元数据标注 generated_at: 2026-08-16，由文档同步流水线持续更新（提交历史显示近期有例行自动再生成） |
| 安装方式 | 插件市场一键安装，或克隆仓库后手动复制 |
2. 功能介绍与亮点
本技能是微软官方 docs2skills 工具从 Microsoft Learn 文档批量生成的 Microsoft Foundry（原 Azure AI Foundry 新版门户）专家知识库。Foundry 是微软当前主推的生成式 AI Agent 开发与运维平台，覆盖模型部署、Agent 托管、评估与可观测性、工具治理等全生命周期。正文以「分类索引」组织九大主题——故障排查、最佳实践、决策辅助、架构与设计模式、限额与配额、安全、配置、集成与编码模式、部署，索引下附精选的 Microsoft Learn 官方文档直达链接，是已核实同仓库姊妹技能中字节体量最大的一份（约 47KB）。
内容分布上，「安全」一节条目数量最多（近 50 条），覆盖 Agent 365 身份治理、Entra RBAC、MCP 工具鉴权、私有网络隔离、客户管理密钥加密、Trace 数据合规等运维治理细节；「配置」与「集成与编码模式」两节次之，涵盖 agent/azure.yaml 配置架构、AI Gateway、LangChain/LangGraph 集成、OpenTelemetry 监控等内容。技术上采用「本地行号索引 + 按需远程抓取」模式：agent 先用本地索引定位相关章节，再通过 mcp_microsoftdocs:microsoft_docs_fetch（或回退到通用网页抓取）取回文档正文。description 中显式声明“不适用于 Foundry 控制平面内容安全 / Foundry 工具中的 Azure Content Understanding / Foundry 工具中的 Azure Speech / Microsoft Foundry Classic（经典版）”，并指路到对应的同仓库姊妹技能，减少 agent 误用。
3. 适用场景
固定分类：DevOps 与基础设施
适用于在 Microsoft Foundry 上构建与运维生成式 AI Agent 生产环境的平台工程师与 MLOps 工程师：为 Foundry 托管 Agent 规划高可用架构、配置 Entra 身份认证与网络隔离（VNet/私有终结点）、管理 AI Gateway 与模型配额限流、通过 MCP 协议集成外部工具时配置鉴权与网络治理、排查托管 Agent 或 Webhook 故障、将 Agent 发布到 M365/Teams 时，都可以让 agent 调用本技能快速定位官方权威指导，避免凭训练记忆给出过时或与 Foundry Classic 概念混淆的建议。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 官方插件市场一键安装（/plugin marketplace add + /plugin install），亦可手动复制到 .claude/skills/ |
| Codex | 原生支持 | 官方插件市场一键安装（codex plugin marketplace add），亦可手动复制到 .codex/skills/ |
| OpenClaw | 未验证 | README 明确列出的受支持工具（Claude Code / Gemini CLI / Codex CLI / Antigravity IDE / GitHub Copilot / Cursor / OpenCode / AdaL CLI）未包含 OpenClaw；技能遵循通用的 Agent Skills 开放标准，理论上可手动安装，但未见官方或第三方验证 |
| Hermes Agent | 未验证 | 同上，README 未提及，且未找到第三方验证信息 |
5. 推荐理由
它把 Microsoft Learn 上零散分布在上百个文档页面的 Foundry 新版运维知识预编译成一份可检索的结构化索引，尤其在安全治理（Entra 身份、RBAC、MCP 鉴权、网络隔离、密钥加密）这一维度覆盖极广，让 agent 在协助搭建或运维生成式 AI Agent 生产环境这类涉及面广、文档分散的任务时能直接命中官方权威指导；官方持续同步维护，内容随 Azure 官方文档更新而更新，且是已核实同仓库姊妹技能中内容体量最大者。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Microsoft 官方一线厂商出品（发布方即 Azure 所有者）；未见针对本子技能自身的独立热度数据（如独立第三方评测、可量化采用数据）支撑更高档评分 |
| 可用性 | 9 | 插件市场一键安装或克隆复制两种路径皆简单；文档结构完整（九大分类索引 + 精选官方链接，字节体量为已核实同仓库姊妹技能中最大者）；仓库有近期同步更新记录；无付费依赖 |
| 安全性 | 9 | 纯文档/参考类技能，不执行本地代码；仅通过官方 MCP 工具或网页抓取访问 learn.microsoft.com 官方域名，外联目标透明；License 明确；官方账号维护，无造假迹象 |
综合评分：8.3（三项均值）
安全检查清单：①无 shell 命令执行 ②仅联网抓取 Microsoft Learn 官方文档，无其他数据外发 ③不要求 API Key 或其他凭据 ④SKILL.md 正文未见可疑指令或隐蔽外发 ⑤作者为 Microsoft 官方账号，信誉明确 ⑥License 明确（CC BY 4.0 + MIT）⑦近期有周期性维护记录
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
| microsoft-foundry-classic-MicrosoftDocs-Agent-Skills | 同仓库姊妹技能，聚焦 Foundry 经典版（原 Azure AI Foundry Hub/Project 模式）的运维知识 | 服务对象是新旧两代产品版本，Classic 与新版概念不通用；本技能专注新版 Foundry 门户（Agent 365、AI Gateway、Foundry IQ 等新特性），两者互为补充而非重叠 |
| microsoft-foundry-microsoft-skills | 另一 Microsoft 官方仓库（microsoft/skills）出品，聚焦新版 Foundry 的 Agent 全生命周期操作工具，内置 azd 命令行脚手架与意图路由表，帮助用户创建/部署/评估/微调 Agent |
定位是“操作执行工具”——依赖 azd CLI 完成 scaffold/deploy 等实际动作；本技能是“知识参考库”——不执行任何本地操作，只负责按需检索官方文档给出决策与故障排查指导，两者可配合使用而非互相替代 |
8. 用户评价
该技能目前在第三方平台尚无经过验证的具名评价，GitHub 仓库内也未检索到与本技能直接相关的 issue 讨论。
9. 其他补充
仓库同时提供多种 AI 编码助手的安装路径（GitHub Copilot、Gemini CLI、Cursor、Antigravity IDE、OpenCode、AdaL CLI 等），并支持社区通过 issue 反馈内容缺口，官方据此持续修订；仓库当前不接受直接提交的技能改动 PR，需通过更新 Microsoft Learn 官方文档并申请重新抓取生效。
10. 安装使用方式
- 插件市场（推荐，Claude Code / Codex）：Claude Code 执行
/plugin marketplace add MicrosoftDocs/agent-skills，再/plugin install azure-agent-skills@microsoft-agent-skills；Codex 执行codex plugin marketplace add MicrosoftDocs/agent-skills，再从/plugins安装azure-agent-skills。 - 手动安装（全部助手）：
git clone https://github.com/MicrosoftDocs/agent-skills.git，将skills/microsoft-foundry/文件夹复制到目标助手的技能目录（如 Claude Code 的.claude/skills/或~/.claude/skills/）。 - 安装后无需重启，agent 会在识别到 Microsoft Foundry（新版）相关请求时自动加载本技能；技能运行时需要网络访问以抓取 Microsoft Learn 文档正文，若所在环境提供
mcp_microsoftdocs工具优先使用，否则回退到通用网页抓取。
11. 注意事项
- 正文索引依赖网络实时抓取官方文档正文，离线环境下只能看到索引本身，无法取回文档详情。
- 与合集内聚焦其他产品/版本的技能（Foundry Classic、Foundry 控制平面内容安全、Foundry 工具中的 Azure Content Understanding/Azure Speech）是互补而非替代关系，description 已显式声明适用边界，选型前应先确认自己使用的是新版 Foundry 而非 Classic。
- OpenClaw、Hermes Agent 的兼容性未获官方或第三方验证，使用前建议先手动测试 SKILL.md 是否能被正确识别加载。