microsoft-docs 精选

استعلام عن الوثائق الرسمية لشركة Microsoft للعثور على المفاهيم والدروس

编码 Codex CLI MCP 客户端 MIT 7.7 万

在 GitHub 打开

安装方式

cp -r translations/ar/.agents/skills/microsoft-docs ~/.claude/skills/microsoft-docs-2

把该 skill 目录放进客户端 skills 目录。不同客户端的目录可能不同，Claude Code 默认是 ~/.claude/skills/

整仓一次性获取：git clone --depth 1 https://github.com/microsoft/ai-agents-for-beginners.git

依赖与权限

无需 API Key
需要联网访问外部服务
依赖外部命令：node python gh go
以上为按正文与 frontmatter 自动推断的信号，仅供参考；安装前建议先阅读原文。

SKILL.md 正文

来源 microsoft/ai-agents-for-beginners@4c9a275 · 许可 MIT · 内容未修改

Microsoft Docs

مهارة بحث لنظام تقنيات Microsoft. تغطي learn.microsoft.com والتوثيق الذي يعيش خارجه (VS Code، GitHub، Aspire، مستودعات Agent Framework).

الافتراضي: Microsoft Learn MCP

Use these tools for كل شيء على 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). للتحديث: 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`	Extension 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، قم بحل معرّف المكتبة أولاً (مرة واحدة لكل جلسة):

استدعي mcp_context7_resolve-library-id مع اسم التقنية
استدعي mcp_context7_query-docs مع معرّف المكتبة المرجع وسؤال محدد

كتابة استعلامات فعّالة

كن محددًا — تضمّن الإصدار، النية، واللغة:

# ❌ 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"

ضمّن السياق:

الإصدار عندما يكون ذا صلة (.NET 8, Aspire 13, VS Code 1.96)
هدف المهمة (quickstart, tutorial, overview, limits, API reference)
اللغة للوثائق متعددة اللغات (Python, TypeScript, C#)

إخلاء مسؤولية:

تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co‑op Translator (https://github.com/Azure/co-op-translator). بينما نسعى إلى الدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو معلومات غير دقيقة. يجب اعتبار الوثيقة الأصلية باللغة الأصلية هي المصدر المعتمد. للمعلومات الحساسة أو الحرجة، يوصى بالاستعانة بترجمة بشرية محترفة. نحن لا نتحمل أي مسؤولية عن سوء الفهم أو التفسيرات الخاطئة الناتجة عن استخدام هذه الترجمة.