[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69A1XRB2SFHYRMEH0K08EKZ":3,"skill-same:01M69A1XRB2SFHYRMEH0K08EKZ":76},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":22,"publishedAt":25,"linkOnly":26,"markdownContent":27,"markdownBody":28,"frontMatter":29,"refName":30,"commitSha":31,"skillDirectory":32,"forksCount":33,"repositoryHtmlUrl":34,"repositoryHomepageUrl":35,"ownerHtmlUrl":36,"ownerBlogUrl":37,"ownerDescription":38,"updatedAt":39,"install":40,"resources":53},"01M69A1XRB2SFHYRMEH0K08EKZ","microsoft-docs",null,"microsoft\u002Fai-agents-for-beginners","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M6998ZK2275KMJE6Y5SEA2X2",79423,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",[17],{"categoryNo":18,"categoryName":19,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000023","Skill与智能体开发","SCENARIO","使用场景",[23,8,24],"docs","microsoft docs","2026-11-10 10:12:30",false,"---\nname: microsoft-docs\n---\n# Microsoft 文件\n\nMicrosoft 技術生態系統的研究技能。涵蓋 learn.microsoft.com 以及存在於其之外的文檔（VS Code、GitHub、Aspire、Agent Framework 倉庫）。\n\n---\n\n## 預設：Microsoft Learn MCP\n\n使用這些工具搜尋 **learn.microsoft.com** 上的所有內容 — 包括 Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等。這是大多數 Microsoft 文件查詢的主要工具。\n\n| 工具 | 用途 |\n|------|---------|\n| `microsoft_docs_search` | 搜尋 learn.microsoft.com — 概念、指南、教學、配置 |\n| `microsoft_code_sample_search` | 從 Learn 文件中找工作代碼片段。傳入 `language`（`python`、`csharp` 等）可取得最佳結果 |\n| `microsoft_docs_fetch` | 從特定 URL 取得完整頁面內容（當搜尋摘要不足時） |\n\n在需要完整教學、所有配置選項或搜尋摘要被截斷時，請於搜尋後使用 `microsoft_docs_fetch`。\n\n---\n\n## 例外情況：何時使用其他工具\n\n以下類別存在於 **learn.microsoft.com 之外**。請改用指定工具。\n\n### Aspire — 使用 Aspire MCP Server（首選）或 Context7\n\nAspire 文件位於 **aspire.dev**，非 Learn。最佳工具取決於你的 Aspire CLI 版本：\n\n**CLI 13.2+**（推薦）— Aspire MCP 伺服器包含內建的文件搜尋工具：\n\n| MCP 工具 | 說明 |\n|----------|-------------|\n| `list_docs` | 列出 aspire.dev 中所有可用的文件 |\n| `search_docs` | 對 aspire.dev 內容進行加權詞彙搜尋 |\n| `get_doc` | 根據 slug 取得特定文件 |\n\n這些功能隨 Aspire CLI 13.2 版本發布（[PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)）。更新指令：`aspire update --self --channel daily`。\n\n**CLI 13.1** — MCP 伺服器提供整合查詢（`list_integrations`、`get_integration_docs`），但\u003Cstrong>不提供\u003C\u002Fstrong>文件搜尋。請使用 Context7 作為備用：\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | 主要用於指南、整合、CLI 參考、部署 |\n| `\u002Fmicrosoft\u002Faspire` | 執行時來源 — API 內部、實作細節 |\n| `\u002Fcommunitytoolkit\u002Faspire` | 社群整合 — Go、Java、Node.js、Ollama |\n\n### VS Code — 使用 Context7\n\nVS Code 文件位於 **code.visualstudio.com**，非 Learn。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | 使用者文件 — 設定、功能、偵錯、遠端開發 |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | 擴充 API — 網頁檢視、樹狀檢視、指令、貢獻點 |\n\n### GitHub — 使用 Context7\n\nGitHub 文件位於 **docs.github.com** 與 **cli.github.com**。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions、API、倉庫、安全性、管理、Copilot |\n| `\u002Fwebsites\u002Fcli_github` | GitHub CLI（`gh`）指令及參數 |\n\n### Agent Framework — 使用 Learn MCP + Context7\n\nAgent Framework 教學在 learn.microsoft.com（使用 `microsoft_docs_search`），但 **GitHub 倉庫** 提供的 API 細節往往比已發布文件更新 — 特別是 DevUI REST API 參考、CLI 選項及 .NET 整合。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | 教學 — DevUI 指南、追蹤、工作流編排 |\n| `\u002Fmicrosoft\u002Fagent-framework` | API 細節 — DevUI REST 端點、CLI 參數、驗證、.NET `AddDevUI`\u002F`MapDevUI` |\n\n**DevUI 小秘訣：** 先從 Learn 網站原始碼查詢操作指南，再從倉庫原始碼查詢 API 細節（端點架構、代理配置、驗證令牌）。\n\n---\n\n## Context7 設定\n\n對任何 Context7 查詢，請先解析函式庫 ID（每次會話一次即可）：\n\n1. 呼叫 `mcp_context7_resolve-library-id` 並指定技術名稱\n2. 使用返回的函式庫 ID 和特定查詢呼叫 `mcp_context7_query-docs`\n\n---\n\n## 撰寫有效查詢\n\n要具體 — 包含版本、意圖和程式語言：\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\n包含上下文：\n- 有相關時包含 \u003Cstrong>版本\u003C\u002Fstrong>（`.NET 8`、`Aspire 13`、`VS Code 1.96`）\n- \u003Cstrong>任務意圖\u003C\u002Fstrong>（`quickstart`、`tutorial`、`overview`、`limits`、`API reference`）\n- 多語言文件請包含 \u003Cstrong>語言\u003C\u002Fstrong>（`Python`、`TypeScript`、`C#`）\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**免責聲明**：\n此文件已使用 AI 翻譯服務 [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator) 進行翻譯。雖然我們努力追求準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於關鍵資訊，建議採用專業人工翻譯。我們不對因使用此翻譯所產生的任何誤解或誤譯承擔責任。\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->","# Microsoft 文件\n\nMicrosoft 技術生態系統的研究技能。涵蓋 learn.microsoft.com 以及存在於其之外的文檔（VS Code、GitHub、Aspire、Agent Framework 倉庫）。\n\n---\n\n## 預設：Microsoft Learn MCP\n\n使用這些工具搜尋 **learn.microsoft.com** 上的所有內容 — 包括 Azure、.NET、M365、Power Platform、Agent Framework、Semantic Kernel、Windows 等。這是大多數 Microsoft 文件查詢的主要工具。\n\n| 工具 | 用途 |\n|------|---------|\n| `microsoft_docs_search` | 搜尋 learn.microsoft.com — 概念、指南、教學、配置 |\n| `microsoft_code_sample_search` | 從 Learn 文件中找工作代碼片段。傳入 `language`（`python`、`csharp` 等）可取得最佳結果 |\n| `microsoft_docs_fetch` | 從特定 URL 取得完整頁面內容（當搜尋摘要不足時） |\n\n在需要完整教學、所有配置選項或搜尋摘要被截斷時，請於搜尋後使用 `microsoft_docs_fetch`。\n\n---\n\n## 例外情況：何時使用其他工具\n\n以下類別存在於 **learn.microsoft.com 之外**。請改用指定工具。\n\n### Aspire — 使用 Aspire MCP Server（首選）或 Context7\n\nAspire 文件位於 **aspire.dev**，非 Learn。最佳工具取決於你的 Aspire CLI 版本：\n\n**CLI 13.2+**（推薦）— Aspire MCP 伺服器包含內建的文件搜尋工具：\n\n| MCP 工具 | 說明 |\n|----------|-------------|\n| `list_docs` | 列出 aspire.dev 中所有可用的文件 |\n| `search_docs` | 對 aspire.dev 內容進行加權詞彙搜尋 |\n| `get_doc` | 根據 slug 取得特定文件 |\n\n這些功能隨 Aspire CLI 13.2 版本發布（[PR #14028](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Faspire\u002Fpull\u002F14028)）。更新指令：`aspire update --self --channel daily`。\n\n**CLI 13.1** — MCP 伺服器提供整合查詢（`list_integrations`、`get_integration_docs`），但\u003Cstrong>不提供\u003C\u002Fstrong>文件搜尋。請使用 Context7 作為備用：\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fmicrosoft\u002Faspire.dev` | 主要用於指南、整合、CLI 參考、部署 |\n| `\u002Fmicrosoft\u002Faspire` | 執行時來源 — API 內部、實作細節 |\n| `\u002Fcommunitytoolkit\u002Faspire` | 社群整合 — Go、Java、Node.js、Ollama |\n\n### VS Code — 使用 Context7\n\nVS Code 文件位於 **code.visualstudio.com**，非 Learn。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fcode_visualstudio` | 使用者文件 — 設定、功能、偵錯、遠端開發 |\n| `\u002Fwebsites\u002Fcode_visualstudio_api` | 擴充 API — 網頁檢視、樹狀檢視、指令、貢獻點 |\n\n### GitHub — 使用 Context7\n\nGitHub 文件位於 **docs.github.com** 與 **cli.github.com**。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Fgithub_en` | Actions、API、倉庫、安全性、管理、Copilot |\n| `\u002Fwebsites\u002Fcli_github` | GitHub CLI（`gh`）指令及參數 |\n\n### Agent Framework — 使用 Learn MCP + Context7\n\nAgent Framework 教學在 learn.microsoft.com（使用 `microsoft_docs_search`），但 **GitHub 倉庫** 提供的 API 細節往往比已發布文件更新 — 特別是 DevUI REST API 參考、CLI 選項及 .NET 整合。\n\n| 函式庫 ID | 用途 |\n|---|---|\n| `\u002Fwebsites\u002Flearn_microsoft_en-us_agent-framework` | 教學 — DevUI 指南、追蹤、工作流編排 |\n| `\u002Fmicrosoft\u002Fagent-framework` | API 細節 — DevUI REST 端點、CLI 參數、驗證、.NET `AddDevUI`\u002F`MapDevUI` |\n\n**DevUI 小秘訣：** 先從 Learn 網站原始碼查詢操作指南，再從倉庫原始碼查詢 API 細節（端點架構、代理配置、驗證令牌）。\n\n---\n\n## Context7 設定\n\n對任何 Context7 查詢，請先解析函式庫 ID（每次會話一次即可）：\n\n1. 呼叫 `mcp_context7_resolve-library-id` 並指定技術名稱\n2. 使用返回的函式庫 ID 和特定查詢呼叫 `mcp_context7_query-docs`\n\n---\n\n## 撰寫有效查詢\n\n要具體 — 包含版本、意圖和程式語言：\n\n```\n# ❌ Too broad\n\"Azure Functions\"\n\"agent framework\"\n\n# ✅ Specific\n\"Azure Functions Python v2 programming model\"\n\"Cosmos DB partition key design best practices\"\n\"GitHub Actions workflow_dispatch inputs matrix strategy\"\n\"Aspire AddUvicornApp Python FastAPI integration\"\n\"DevUI serve agents tracing OpenTelemetry directory discovery\"\n\"Agent Framework workflow conditional edges branching handoff\"\n```\n\n包含上下文：\n- 有相關時包含 \u003Cstrong>版本\u003C\u002Fstrong>（`.NET 8`、`Aspire 13`、`VS Code 1.96`）\n- \u003Cstrong>任務意圖\u003C\u002Fstrong>（`quickstart`、`tutorial`、`overview`、`limits`、`API reference`）\n- 多語言文件請包含 \u003Cstrong>語言\u003C\u002Fstrong>（`Python`、`TypeScript`、`C#`）\n\n---\n\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER START -->\n**免責聲明**：\n此文件已使用 AI 翻譯服務 [Co-op Translator](https:\u002F\u002Fgithub.com\u002FAzure\u002Fco-op-translator) 進行翻譯。雖然我們努力追求準確性，但請注意自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應視為權威來源。對於關鍵資訊，建議採用專業人工翻譯。我們不對因使用此翻譯所產生的任何誤解或誤譯承擔責任。\n\u003C!-- CO-OP TRANSLATOR DISCLAIMER END -->",{"name":5},"main","f09e94ffe170f8af6d3db7c42987bbe4db227723","translations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs",26019,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners","https:\u002F\u002Faka.ms\u002Fai-agents-beginners","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-07 12:51:12",{"source":7,"skillName":5,"commands":41,"prompt":51,"zipAvailable":52},[42,45,48],{"tool":43,"command":44},"npx","npx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":46,"command":47},"bunx","bunx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs",{"tool":49,"command":50},"pnpm","pnpm dlx skills add microsoft\u002Fai-agents-for-beginners --skill microsoft-docs","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fmicrosoft-docs\u002FSKILL.md",true,[54,60,64,70],{"path":55,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":58,"sourceHtmlUrl":59},"assets\u002FChart.yaml.template","ASSET","资产文件",801,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fkubernetes-operations\u002Fskills\u002Fhelm-chart-scaffolding\u002Fassets\u002FChart.yaml.template",{"path":61,"resourceType":56,"resourceTypeDesc":57,"sizeBytes":62,"sourceHtmlUrl":63},"assets\u002Fvalues.yaml.template",3190,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fkubernetes-operations\u002Fskills\u002Fhelm-chart-scaffolding\u002Fassets\u002Fvalues.yaml.template",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"references\u002Fchart-structure.md","REFERENCE","参考文档",11775,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fkubernetes-operations\u002Fskills\u002Fhelm-chart-scaffolding\u002Freferences\u002Fchart-structure.md",{"path":71,"resourceType":72,"resourceTypeDesc":73,"sizeBytes":74,"sourceHtmlUrl":75},"scripts\u002Fvalidate-chart.sh","SCRIPT","脚本",6506,"https:\u002F\u002Fgithub.com\u002Fshengdabai\u002FTony-Claude-Code-Skills\u002Fblob\u002Fmain\u002Fskills\u002F_collections\u002Fplugins\u002Fkubernetes-operations\u002Fskills\u002Fhelm-chart-scaffolding\u002Fscripts\u002Fvalidate-chart.sh",[77,93,101,109,116,123],{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":90,"publishedAt":25},"01M69A206TRZ8KK0CW0HYJF5V5","testing-course-samples","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[82,85],{"categoryNo":83,"categoryName":84,"taxonomyType":20,"taxonomyTypeDesc":21},"01JBSEEDCAT000000000000008","测试与质量",{"categoryNo":86,"categoryName":87,"taxonomyType":88,"taxonomyTypeDesc":89},"01JBSEEDCAT000000000000039","教师与教育","PROFESSION","适用职业",[91,92],"testing","testing course samples",{"skillNo":94,"name":95,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":25},"01M69A1VPZFJQ1HNGTZQ5P3WSC","local-ai-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Flocal-ai-agents\u002FSKILL.md",[],[99,100],"ai agents","local ai agents",{"skillNo":102,"name":103,"nameZh":6,"description":104,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":105,"categories":106,"keywords":107,"publishedAt":25},"01M69A1S947N7MM6V9JF85S2E7","jupyter-notebook","當使用者要求建立、搭建或編輯 Jupyter 筆記本（`.ipynb`）用於實驗、探索或教學時使用；優先使用隨附範本並執行輔助腳本 `new_notebook.py` 來產生一個乾淨的起始筆記本。","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fjupyter-notebook\u002FSKILL.md",[],[108],"jupyter notebook",{"skillNo":110,"name":111,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":25},"01M69A1Q8EXPWKZSQK69V6WF22","deploying-scalable-agents","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fdeploying-scalable-agents\u002FSKILL.md",[],[115],"deploying scalable agents",{"skillNo":117,"name":118,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":119,"categories":120,"keywords":121,"publishedAt":25},"01M69A1MHZTH3RH9N8VYSYG74X","azure-openai-to-responses","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-TW\u002F.agents\u002Fskills\u002Fazure-openai-to-responses\u002FSKILL.md",[],[122],"azure openai to responses",{"skillNo":124,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":129,"publishedAt":25},"01M69A1J59TJWN7MV1FV5TG443","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fai-agents-for-beginners\u002Fblob\u002Fmain\u002Ftranslations\u002Fzh-MO\u002F.agents\u002Fskills\u002Ftesting-course-samples\u002FSKILL.md",[127,128],{"categoryNo":83,"categoryName":84,"taxonomyType":20,"taxonomyTypeDesc":21},{"categoryNo":86,"categoryName":87,"taxonomyType":88,"taxonomyTypeDesc":89},[91,92]]