Skip to content
Skills Library
Programming · Research

microsoft-docs

/microsoft-docs

查询官方 Microsoft 文档,以查找有关 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教程和代码示例。默认使用 Microsoft Learn MCP,对于存在于 learn.microsoft.com 之外的内容,则使用 Context7 和 Aspire MCP。

Licence
MIT
Last repository change
24.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
2
URLs in SKILL.md
3
Deprecation

No signals detected. Repository changed on 24.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

What it does and when to use it

查询官方 Microsoft 文档,以查找有关 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教程和代码示例。默认使用 Microsoft Learn MCP,对于存在于 learn.microsoft.com 之外的内容,则使用 Context7 和 Aspire MCP。

Original author description

查询官方 Microsoft 文档,以查找有关 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub 等的概念、教程和代码示例。默认使用 Microsoft Learn MCP,对于存在于 learn.microsoft.com 之外的内容,则使用 Context7 和 Aspire MCP。

How it works

  1. 默认:Microsoft Learn MCP
  2. 例外:何时使用其他工具
  3. Context7 设置
  4. 编写有效的查询
Original SKILL.md headings · 115 lines, 415 words
SKILL.md preview
---
name: microsoft-docs
description: 查询官方 Microsoft 文档,以查找有关 Azure、.NET、Agent Framework、Aspire、VS Code、GitHub
  等的概念、教程和代码示例。默认使用 Microsoft Learn MCP,对于存在于 learn.microsoft.com 之外的内容,则使用 Context7
  和 Aspire MCP。
---
# Microsoft 文档

研究 Microsoft 技术生态系统的检索技能。涵盖 learn.microsoft.com 以及存在于其外部的文档(VS Code、GitHub、Aspire、Agent Framework 仓库)。

---

## 默认:Microsoft Learn MCP

对 **learn.microsoft.com** 上的所有内容使用这些工具 —— Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等等。对于绝大多数 Microsoft 文档查询,这是主要工具。

| Tool | Purpose |
|------|---------|
| `microsoft_docs_search` | 在 learn.microsoft.com 上搜索 —— 概念、指南、教程、配置 |
| `microsoft_code_sample_search` | 查找来自 Learn 文档的可运行代码片段。传入 `language`(`python`、`csharp` 等)以获得最佳结果 |
| `microsoft_docs_fetch` | 从特定 URL 获取完整页面内容(当搜索摘录不足时) |

当需要完整教程、所有配置选项或搜索摘录被截断时,在搜索之后使用 `microsoft_docs_fetch`。

---

## 例外:何时使用其他工具

以下类别位于 learn.microsoft.com **之外**。请改用指定的工具。

### .NET Aspire — 使用 Aspire MCP Server(首选)或 Context7

Aspire 文档位于 **aspire.dev**,而不是 Learn。最佳工具取决于你的 Aspire CLI 版本:

**CLI 13.2+**(推荐)—— Aspire MCP 服务器包含内置的文档搜索工具:

| MCP Tool | Description |
|----------|-------------|
| `list_docs` | 列出来自 aspire.dev 的所有可用文档 |
| `search_docs` | 跨 aspire.dev 内容的加权词汇搜索 |
| `get_doc` | 按 slug 检索特定文档 |

这些包含于 Aspire CLI 13.2([PR #14028](https://github.com/dotnet/aspire/pull/14028))。要更新:`aspire update --self --channel daily`。参考: https://davidpine.dev/posts/aspire-docs-mcp-tools/

**CLI 13.1** —— MCP 服务器提供集成查找(`list_integrations`, `get_integration_docs`),但**不**提供文档搜索。回退使用 Context7:

| Library ID | Use for |
|---|---|
| `/microsoft/aspire.dev` | 主要 —— 指南、集成、CLI 参考、部署 |
| `/dotnet/aspire` | 运行时源码 —— API 内部、实现细节 |
| `/communitytoolkit/aspire` | 社区集成 —— Go、Java、Node.js、Ollama |

### VS Code — 使用 Context7

VS Code 文档位于 **code.visualstudio.com**,而不是 Learn。

| Library ID | Use for |
|---|---|
| `/websites/code_visualstudio` | 用户文档 —— 设置、功能、调试、远程开发 |
| `/websites/code_visualstudio_api` | 扩展 API —— webviews、TreeViews、命令、贡献点 |

### GitHub — 使用 Context7

GitHub 文档位于 **docs.github.com** 和 **cli.github.com**。

| Library ID | Use for |
|---|---|
| `/websites/github_en` | Actions、API、仓库、安全、管理、Copilot |
| `/websites/cli_github` | GitHub CLI(`gh`)命令和标志 |

### Agent Framework — 使用 Learn MCP + Context7

Agent Framework 教程位于 learn.microsoft.com(使用 `microsoft_docs_search`),但 **GitHub 仓库** 包含经常领先于已发布文档的 API 级别细节 —— 特别是 DevUI REST API 参考、CLI 选项和 .NET 集成。

| Library ID | Use for |
|---|---|
| `/websites/learn_microsoft_en-us_agent-framework` | 教程 —— DevUI 指南、追踪、工作流编排 |
| `/microsoft/agent-framework` | API 细节 —— DevUI REST 端点、CLI 标志、身份验证、.NET `AddDevUI`/`MapDevUI` |

**DevUI 提示:** 先查询 Learn 网站源码以获取操作指南,然后查询仓库源码以获取 API 级别的具体信息(端点模式、代理配置、身份验证令牌)。

---

## Context7 设置

对于任何 Context7 查询,首先解析 library ID(每会话一次):

1. 调用 `mcp_context7_resolve-library-id` 并传入技术名称
2. 调用 `mcp_context7_query-docs` 并使用返回的 library ID 以及具体查询

---

## 编写有效的查询

要具体 —— 包含版本、意图和语言:

```
# ❌ Too broad
"Azure Functions"
"agent framework"

# ✅ Specific
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"GitHub Actions workflow_dispatch inputs matrix strategy"
"Aspire AddUvicornApp Python FastAPI integration"
"DevUI serve agents tracing OpenTelemetry directory discovery"
"Agent Framework workflow conditional edges branching handoff"
```

Include context:
- **Version** when relevant (`.NET 8`, `Aspire 13`, `VS Code 1.96`)
- **Task intent** (`quickstart`, `tutorial`, `overview`, `limits`, `API reference`)
- **Language** for polyglot docs (`Python`, `TypeScript`, `C#`)

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
免责声明:
本文件已使用 AI 翻译服务 Co‑op Translator(https://github.com/Azure/co-op-translator)进行翻译。尽管我们力求准确,但请注意自动翻译可能包含错误或不准确之处。原始语言的文档应被视为权威版本。对于关键信息,建议采用专业人工翻译。因使用本翻译而产生的任何误解或曲解,我们不承担责任。
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

Versions

RepositoryScoreLicence
This page · microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoft/ai-agents-for-beginners100MIT
microsoftdocs/mcp100CC-BY-4.0
sandbaseai/sandbase-skills90Apache-2.0

Identical content appears in 1 other GitHub folders. We show one copy with the highest score.

Database snapshot: 13.11.2026 · package version a0fdc111c5f0 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100microsoft-development
    Microsoft docs lookup, code samples, and SDK reference for Azure, .NET, Microsoft 365, Windows, and Power Platform via Microsoft Learn MCP. Use for API reference or official MS documentation retrieval.
  • 100microsoft-learn-cli
    Use the Microsoft Learn CLI to retrieve current official Microsoft documentation and code samples when Microsoft Learn MCP tools are unavailable. Use for questions about Microsoft technologies, SDKs, APIs, configuration, limits, best practices, tutorials, or Microsoft-specific…
  • 100aspire
    **WORKFLOW SKILL** - Orchestrates Aspire applications using the Aspire CLI and MCP tools for running, debugging, and managing distributed apps. USE FOR: aspire run, aspire stop, start aspire app, check aspire resources, list aspire integrations, debug aspire issues, view aspire…
  • 100aspire-restart
    Start or restart the .NET Aspire AppHost via the developer CLI. Always use this, never the developer CLI's `run` command, `aspire run`, or `aspire restart`.
  • 100ms-docs-researcher
    Search and retrieve official Microsoft documentation, code samples, and technical information. Use PROACTIVELY when researching Azure AI Search, Copilot Studio, Azure Cognitive Services, Azure App Service, Microsoft 365, Power Platform, Power Automate, or Power Apps. Trigger on:…
  • 100issue-investigation
    Investigates GitHub issues in microsoft/aspire by gathering issue context, routing to specialized skills, preparing the right reproduction environment, reproducing behavior, and drafting evidence-backed findings or insufficient-info comments for user approval. Use when asked to…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.