关于 microsoft-docs
用于查找 Microsoft Learn 内容并获取完整页面的文档检索技能。支持针对概念、教程、配置、限制和最佳实践进行查询,也提供 `mslearn` 命令行替代方式。
主要功能
- 01搜索 Microsoft 文档
- 02获取完整文档页面
- 03提供精准查询指南
- 04提供 `mslearn` 命令行替代方式
适用场景
- 01查询服务概念和架构
- 02查找教程及配置详情
- 03核实服务限制或最佳实践
MCP 相关
通过 `microsoft_docs_search` 和 `microsoft_docs_fetch` 工具搜索并获取 MCP 中的 Microsoft 文档。如果 Learn MCP 服务不可用,文档提供了对应的 `mslearn` 命令行用法。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ microsoft/ skills --skill microsoft-docs安装后在 Claude Code 中输入/microsoft-docs确认已加载。
详细介绍
Microsoft Docs
工具
| 工具 | 用途 |
|---|---|
microsoft_docs_search | 查找文档——概念、指南、教程、配置 |
microsoft_docs_fetch | 获取完整页面内容(搜索摘要不够时) |
使用场景
- 了解概念 — “Cosmos DB 分区如何工作?”
- 学习服务 — “Azure Functions 概述”、“Container Apps 架构”
- 查找教程 — “quickstart”、“getting started”、“step-by-step”
- 配置选项 — “App Service 配置设置”
- 限制和配额 — “Azure OpenAI 速率限制”、“Service Bus 配额”
- 最佳实践 — “Azure 安全最佳实践”
查询效果
好的查询应具体明确:
# ❌ Too broad
"Azure Functions"
# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"
包含上下文:
- 版本(如适用)(
.NET 8、EF Core 8) - 任务意图(
quickstart、tutorial、overview、limits) - 平台(适用于多平台文档)(
Linux、Windows)
何时获取完整页面
在搜索后获取完整页面的情况:
- 教程 — 需要完整的分步说明
- 配置指南 — 需要列出所有选项
- 深入探讨 — 用户需要全面介绍
- 搜索摘要被截断 — 需要完整上下文
为什么使用它
- 准确性 — 实时文档,而非可能过时的训练数据
- 完整性 — 教程包含所有步骤,而非零散片段
- 权威性 — Microsoft 官方文档
CLI 替代方案
如果 Learn MCP 服务不可用,可改用命令行中的 mslearn CLI:
# Run directly (no install needed)
npx @microsoft/learn-cli search "azure functions timeout"
# Or install globally, then run
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"
| MCP 工具 | CLI 命令 |
|---|---|
microsoft_docs_search(query: "...") | mslearn search "..." |
microsoft_docs_fetch(url: "...") | mslearn fetch "..." |
fetch 命令还支持使用 --section <heading> 提取单个章节,并使用 --max-chars <number> 截断输出。
评论
支持 Markdown