microsoft-docs

Comprendre les technologies Microsoft en interrogeant la documentation officielle. À utiliser chaque fois que l'utilisateur demande comment quelque chose fonctionne, veut des tutoriels, a besoin d'options de configuration, de limites, de quotas ou de bonnes pratiques pour toute technologie Microsoft (Azure, .NET, M365, Windows, Power Platform, etc.) - même s'il ne mentionne pas « docs ». Si la question porte sur la compréhension d'un concept plutôt que sur l'écriture de code, c'est la bonne compétence.

npx skills add https://github.com/microsoft/skills --skill microsoft-docs

Microsoft Docs

Outils

Outil Utilisation
microsoft_docs_search Trouver de la documentation—concepts, guides, tutoriels, configuration
microsoft_docs_fetch Obtenir le contenu complet de la page (quand les extraits de recherche ne suffisent pas)

Quand l'utiliser

  • Comprendre des concepts — "How does Cosmos DB partitioning work?"
  • Apprendre un service — "Azure Functions overview", "Container Apps architecture"
  • Trouver des tutoriels — "quickstart", "getting started", "step-by-step"
  • Options de configuration — "App Service configuration settings"
  • Limites et quotas — "Azure OpenAI rate limits", "Service Bus quotas"
  • Bonnes pratiques — "Azure security best practices"

Efficacité des requêtes

Les bonnes requêtes sont spécifiques :

# ❌ Trop large
"Azure Functions"

# ✅ Spécifique
"Azure Functions Python v2 programming model"
"Cosmos DB partition key design best practices"
"Container Apps scaling rules KEDA"

Incluez du contexte :

  • Version si pertinent (.NET 8, EF Core 8)
  • Intention de la tâche (quickstart, tutorial, overview, limits)
  • Plateforme pour les docs multi-plateforme (Linux, Windows)

Quand récupérer la page complète

Récupérez après une recherche quand :

  • Tutoriels — besoin d'instructions complètes étape par étape
  • Guides de configuration — besoin de toutes les options listées
  • Approfondissements — l'utilisateur veut une couverture complète
  • L'extrait de recherche est coupé — contexte complet nécessaire

Pourquoi l'utiliser

  • Précision — documentation en direct, pas de données d'entraînement potentiellement obsolètes
  • Complétude — les tutoriels contiennent toutes les étapes, pas des fragments
  • Autorité — documentation officielle Microsoft

Alternative CLI

Si le serveur Learn MCP n'est pas disponible, utilisez plutôt le CLI mslearn depuis la ligne de commande :

# Exécutez directement (aucune installation requise)
npx @microsoft/learn-cli search "azure functions timeout"

# Ou installez globalement, puis exécutez
npm install -g @microsoft/learn-cli
mslearn search "azure functions timeout"
Outil MCP Commande CLI
microsoft_docs_search(query: "...") mslearn search "..."
microsoft_docs_fetch(url: "...") mslearn fetch "..."

La commande fetch supporte aussi --section <heading> pour extraire une seule section et --max-chars <number> pour tronquer la sortie.