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. Default: Microsoft Learn MCP
  2. Exceptions: When to Use Other Tools
  3. Context7 Setup
  4. Writing Effective Queries
Original SKILL.md headings · 115 lines, 595 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 Docs

Research skill for the Microsoft technology ecosystem. Covers learn.microsoft.com and documentation that lives outside it (VS Code, GitHub, Aspire, Agent Framework repos).

---

## Default: Microsoft Learn MCP

Use these tools for **learn.microsoft.com 上的所有內容** — Azure, .NET, M365, Power Platform, Agent Framework, Semantic Kernel, Windows, and more. This is the primary tool for the vast majority of Microsoft documentation queries.

| Tool | Purpose |
|------|---------|
| `microsoft_docs_search` | 在 learn.microsoft.com 搜尋 — 概念、指南、教學、設定 |
| `microsoft_code_sample_search` | 從 Learn 文件中尋找可運行的程式碼片段。傳入 `language`(`python`、`csharp` 等)以獲得最佳結果 |
| `microsoft_docs_fetch` | 從特定 URL 取得完整頁面內容(當搜尋摘錄不足時) |

Use `microsoft_docs_fetch` after search when you need complete tutorials, all config options, or when search excerpts are truncated.

---

## Exceptions: When to Use Other Tools

The following categories live **outside** learn.microsoft.com. Use the specified tool instead.

### .NET Aspire — Use Aspire MCP Server (preferred) or Context7

Aspire docs live on **aspire.dev**, not Learn. The best tool depends on your Aspire CLI version:

**CLI 13.2+** (recommended) — The Aspire MCP server includes built-in docs search tools:

| MCP Tool | Description |
|----------|-------------|
| `list_docs` | Lists all available documentation from aspire.dev |
| `search_docs` | Weighted lexical search across aspire.dev content |
| `get_doc` | Retrieves a specific document by slug |

These ship in Aspire CLI 13.2 ([PR #14028](https://github.com/dotnet/aspire/pull/14028)). To update: `aspire update --self --channel daily`. 參考: https://davidpine.dev/posts/aspire-docs-mcp-tools/

**CLI 13.1** — The MCP server provides integration lookup (`list_integrations`, `get_integration_docs`) but **not** docs search. Fall back to Context7:

| Library ID | Use for |
|---|---|
| `/microsoft/aspire.dev` | Primary — guides, integrations, CLI reference, deployment |
| `/dotnet/aspire` | Runtime source — API internals, implementation details |
| `/communitytoolkit/aspire` | Community integrations — Go, Java, Node.js, Ollama |

### VS Code — Use Context7

VS Code docs live on **code.visualstudio.com**, not Learn.

| Library ID | Use for |
|---|---|
| `/websites/code_visualstudio` | User docs — settings, features, debugging, remote dev |
| `/websites/code_visualstudio_api` | Extension API — webviews, TreeViews, commands, contribution points |

### GitHub — Use Context7

GitHub docs live on **docs.github.com** and **cli.github.com**.

| Library ID | Use for |
|---|---|
| `/websites/github_en` | Actions, API, repos, security, admin, Copilot |
| `/websites/cli_github` | GitHub CLI (`gh`) commands and flags |

### Agent Framework — Use Learn MCP + Context7

Agent Framework tutorials are on learn.microsoft.com (use `microsoft_docs_search`), but the **GitHub repo** has API-level detail that is often ahead of published docs — particularly DevUI REST API reference, CLI options, and .NET integration.

| Library ID | Use for |
|---|---|
| `/websites/learn_microsoft_en-us_agent-framework` | Tutorials — DevUI guides, tracing, workflow orchestration |
| `/microsoft/agent-framework` | API detail — DevUI REST endpoints, CLI flags, auth, .NET `AddDevUI`/`MapDevUI` |

**DevUI 小貼士:** 先查詢 Learn 網站來源以取得操作指南,然後查詢儲存庫來源以取得 API 級別的細節(端點 schema、代理設定、驗證令牌)。

---

## Context7 Setup

For any Context7 query, resolve the library ID first (one-time per session):

1. Call `mcp_context7_resolve-library-id` with the technology name
2. Call `mcp_context7_query-docs` with the returned library ID and a specific query

---

## Writing Effective Queries

Be specific — include version, intent, and language:

```
# ❌ 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:
- **版本**(視情況而定)(` .NET 8`, `Aspire 13`, `VS Code 1.96`)
- **任務目的**(`quickstart`, `tutorial`, `overview`, `limits`, `API reference`)
- **語言**,針對多語言文件(`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 ff4f7fa7d7bd (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.