微软技术文档检索

为什么需要这个技能

查微软技术文档时，你可能会遇到三个具体麻烦：一是文档分散在多个站点——多数内容在 learn.microsoft.com，但 .NET Aspire 文档在 aspire.dev，VS Code 文档在 code.visualstudio.com，GitHub 文档在 docs.github.com 和 cli.github.com；二是代码示例不好找，尤其是按编程语言过滤的有效片段；三是搜索结果经常截断，要翻页才能拿到完整教程或配置项。

技能如何工作

该技能按「默认工具优先、例外场景分流」的逻辑设计。

• 默认路径：针对 learn.microsoft.com 的内容，优先使用 Microsoft Learn MCP 的三个工具：microsoft_docs_search 用于搜索概念、指南、教程和配置；microsoft_code_sample_search 用于找可运行的代码片段，建议传入 python、csharp 等语言参数；microsoft_docs_fetch 用于获取指定 URL 的完整页面，当搜索摘要被截断或需要全部配置项时使用。
• CLI 替代方案：如果 Learn MCP 服务不可用，可在终端或 shell（如 Bash、PowerShell、cmd）中使用 mslearn 命令，对应关系为：mslearn search 对应 microsoft_docs_search，mslearn code-search --language 对应 microsoft_code_sample_search，mslearn fetch 对应 microsoft_docs_fetch。给 search 或 code-search 加 --json 参数可获取原始 JSON 输出，方便后续处理。
• 例外场景：.NET Aspire、VS Code、GitHub、Agent Framework 等文档不在 Learn 上的技术，需切换工具。例如 Aspire CLI 13.2+ 推荐用 Aspire MCP Server（含 list_docs、search_docs、get_doc），13.1 版本则回退到 Context7；VS Code 用 Context7 的 /websites/code_visualstudio（用户文档）或 /websites/code_visualstudio_api（扩展 API）；GitHub 用 /websites/github_en（Actions、API、Copilot 等）或 /websites/cli_github（gh 命令）；Agent Framework 则 Learn MCP 与 Context7 配合使用，教程查 Learn，API 细节查 GitHub 仓库。

适用边界与注意点

• Context7 查询前必须先解析库 ID：先调用 mcp_context7_resolve-library-id，再用返回的 ID 调用 mcp_context7_query-docs。
• Aspire 的工具选择取决于 CLI 版本：13.2+ 用 Aspire MCP，13.1 需依赖 Context7 补全文档搜索。
• 查询时尽量带上版本、任务意图和语言（如 .NET 8、quickstart、Python），能让搜索结果更精准。