microsoft-docs

Comprenez les technologies Microsoft en interrogeant la documentation officielle. À utiliser chaque fois que l'utilisateur demande comment quelque chose fonctionne, souhaite 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 le skill approprié.

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 d'une page (quand les extraits de recherche ne suffisent pas)

Quand l'utiliser

  • Comprendre des concepts — « Comment fonctionne le partitionnement de Cosmos DB ? »
  • Apprendre un service — « Vue d'ensemble d'Azure Functions », « Architecture de Container Apps »
  • Trouver des tutoriels — « quickstart », « getting started », « step-by-step »
  • Options de configuration — « Paramètres de configuration App Service »
  • Limites & quotas — « Limites de débit Azure OpenAI », « Quotas Service Bus »
  • Bonnes pratiques — « Bonnes pratiques de sécurité Azure »

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)
  • Intent 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 si :

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

Pourquoi utiliser ceci

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

Alternative CLI

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

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

# Ou installer globalement, puis exécuter
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 section unique et --max-chars <number> pour tronquer la sortie.

Skills similaires