microsoft-docs-github-awesome-copilot

1. 基本信息

项目	内容	数据来源
名称	microsoft-docs（合集仓库子技能，识别名 `microsoft-docs-github-awesome-copilot`）	—
作者/维护者	初版由 TianqiZhang（个人账号，GitHub 资料标注所属 Microsoft，是 microsoftdocs/mcp 仓库的头号贡献者）于 2026-01-14 随 microsoft-code-reference 一并提交至 `github/awesome-copilot`；ChrisMcKee1 于 2026-02 重构为“默认走 Learn、例外走 Context7/Aspire MCP”结构；TianqiZhang 于 2026-03-16 补充 Learn CLI 备选方案（PR #1003）	GitHub API（提交记录）
来源链接	https://github.com/github/awesome-copilot/tree/main/skills/microsoft-docs	—
许可证	MIT（合集仓库）	GitHub API
GitHub Stars / Forks	39,224 / 4,985（属整个 awesome-copilot 合集仓库，不代表本技能自身热度）	GitHub API
最新版本	无独立版本号；该子目录最近一次改动为 2026-03-16	GitHub API（按路径过滤的提交记录）
安装方式	`npx skills add https://github.com/github/awesome-copilot --skill microsoft-docs`，或手动复制目录	skills.sh 页面

2. 功能介绍与亮点

这是一份微软技术文档检索指南（SKILL.md 约 5.7KB，单文件，无脚本）。当你问 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等问题时，它告诉 agent：先去哪查、用哪个工具、怎么写查询词，避免凭训练数据作答。

默认路径：Microsoft Learn。用 microsoft_docs_search（概念与教程）、microsoft_code_sample_search（可运行代码片段，可指定 language）、microsoft_docs_fetch（抓取整页全文）三个工具覆盖 learn.microsoft.com 上的绝大多数内容。
CLI 备选：Learn MCP 不可用时，改用 npx @microsoft/learn-cli search / code-search / fetch，无需先装 MCP，三个子命令与上述三个工具一一对应，加 --json 可拿原始输出。
例外分流：Learn 之外的文档各有去处——Aspire 走 aspire.dev 的 Aspire MCP（CLI 13.2+ 内置 list_docs / search_docs / get_doc），VS Code 与 GitHub 走 Context7 的对应库 ID，Agent Framework 则教程走 Learn、API 细节走仓库源码。
查询写法示例：对比“太宽泛”与“带版本、意图、语言”的写法，如 Azure Functions Python v2 programming model。

3. 适用场景

固定分类：工程效率与代码质量

适合用微软技术栈写代码的开发者：查 SDK 用法与最新 API、找官方代码示例、核对配置项与限额、排查文档与版本对不上的问题；也适合让 agent 在写 Azure/.NET 代码前先查官方文档，减少过时写法。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——遵循 Agent Skills 规范（SKILL.md + YAML front matter），放入 .claude/skills/ 即可加载；检索工具需另行接入 Learn MCP，或直接用其 CLI 备选。
Codex CLI：⚠️ 需适配——Codex 不会自动扫描 ~/.codex/skills，需在会话中手动引用 SKILL.md 内容；npx CLI 路径在 shell 中可直接用。
OpenClaw：❓ 未验证——未查到其加载第三方 SKILL.md 的官方说明。
Hermes Agent：✅ 原生支持——按 tap 路径扫描子目录探测 SKILL.md，兼容标准 Agent Skills 规范。
说明：技能本身只是“怎么查”的指引，能否用满取决于所在 agent 是否接入 Learn MCP / Context7；缺失时退到 mslearn CLI。

5. 推荐理由

微软技术栈更新快，模型训练数据里常见过时 API。这份技能把“去哪查、用什么查、怎么问”固化下来：默认走官方 Learn，Learn 之外的 Aspire、VS Code、GitHub 也给出了对应的库 ID 与工具，并附了不装 MCP 也能用的 CLI 路径。体量小（5.7KB），装上不干扰其他技能，对经常写 Azure/.NET 的初中级开发者是低成本的“先查后写”约束。

6. 评分

维度	分数	说明
受欢迎程度	8	skills.sh 累计约 14.8K 次安装（2026-01-20 首次出现）；两位具名贡献者持续维护；合集仓库 stars 属整个合集，不代表本技能自身热度；第三方平台无具名使用评价
可用性	7	一条 `npx` 命令即可安装，无付费依赖；文档结构清晰、含查询示例与 CLI 备选。扣分：完整能力需另接 Learn MCP，Aspire 与 VS Code 部分还依赖 Context7 或 Aspire MCP；子目录最近改动为 2026-03-16
安全性	8	纯文档、无脚本、无凭据、MIT；skills.sh 上 Gen Agent Trust Hub、Socket、Snyk 三项自动审计均为 PASS；扣分：检索工具会把外部网页内容带入上下文

安全检查清单：①不含 shell 脚本；仅建议运行 npx @microsoft/learn-cli（MIT 许可，发布于 npm，源码在 microsoftdocs/mcp 仓库）②运行时联网仅限文档检索（learn.microsoft.com、aspire.dev 等）③不需要 API key ④通读 SKILL.md，未见可疑指令、混淆内容或夹带推广；文中所有外链均为微软/GitHub 文档或博客 ⑤作者为个人贡献者，经 awesome-copilot 维护者审阅后合并，账号公开可查 ⑥License 明确（MIT）⑦子目录最近改动 2026-03-16，合集仓库当日仍有提交。综合 = 三项均值。

7. 跟同类 Skills 相比的优势

项目	定位	与本技能的差异
Context7 MCP	通用库文档检索服务，覆盖数千个开源库	是检索服务而非使用指引；本技能把 Context7 放在“Learn 之外”的位置，并给出微软相关库 ID，两者可搭配
Microsoft Learn MCP 服务器	微软官方托管的 Learn 文档检索工具集	是工具本身；本技能是使用这些工具的分流与查询规范，且附带无需 MCP 的 CLI 路径
直接让 agent 联网搜索	通用检索，不限站点	结果来源不可控；本技能限定官方来源并区分 Learn 与非 Learn 文档

核心差异：不是又一个检索工具，而是把“微软技术栈该去哪查、怎么问”写成 agent 可遵循的规则。

8. 用户评价

该技能目前在第三方平台尚无具名用户使用评价。可核实的公开痕迹：skills.sh 累计约 14.8K 次安装，三项自动化安全审计通过；GitHub 上 TianqiZhang 与 ChrisMcKee1 两位具名贡献者在 2026-01 至 2026-03 间共提交 8 次改动，包括 ChrisMcKee1 的结构重构与 TianqiZhang 的 CLI 备选补充（PR #1003）。以上是安装数据与代码贡献记录，不是使用者评价。

9. 其他补充

同一合集中还有姊妹技能 microsoft-code-reference（查 API 签名与代码验证）。正文为英文，无多语言版本。

10. 安装使用方式

安装：npx skills add https://github.com/github/awesome-copilot --skill microsoft-docs，或手动复制 skills/microsoft-docs/ 到你的 skills 目录。
可选：接入 Microsoft Learn MCP；不接入时，agent 会退到 npx @microsoft/learn-cli（需本机有 Node.js）。
触发：问“Azure Functions Python v2 怎么配置绑定”“Cosmos DB 分区键设计最佳实践”之类微软技术问题。安装后无需重启。

11. 注意事项

文档检索依赖网络与所在 agent 的 MCP/CLI 配置；离线环境下无法使用。
Aspire 文档工具需 Aspire CLI 13.2+；旧版本要退到 Context7，文中已说明。
技能只规定去哪查，不保证检索结果正确；检索到的网页内容仍应由你复核。
文中库 ID 与工具名（如 Context7 的 /websites/code_visualstudio）可能随上游变动，落地前建议试查一次。