wiki-qa

Répond à des questions sur un dépôt de code en utilisant l'analyse des fichiers source. À utiliser lorsque l'utilisateur pose une question sur le fonctionnement de quelque chose, souhaite comprendre un composant ou a besoin d'aide pour naviguer dans la base de code.

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

Wiki Q&A

Référentiel de réponses aux questions basées entièrement sur les preuves du code source.

Quand Activer

  • L'utilisateur pose une question sur la base de code
  • L'utilisateur souhaite comprendre un fichier, une fonction ou un composant spécifique
  • L'utilisateur demande « comment X fonctionne » ou « où Y est défini »

Résolution du Référentiel Source (À FAIRE EN PREMIER)

Avant de répondre à toute question, vous DEVEZ déterminer le contexte du référentiel source :

  1. Vérifiez la remote git : Exécutez git remote get-url origin pour détecter s'il existe une remote
  2. Demandez à l'utilisateur : « S'agit-il d'un référentiel local uniquement, ou disposez-vous d'une URL de référentiel source (p. ex. GitHub, Azure DevOps) ? »
    • URL remote fournie → stocker en tant que REPO_URL, utiliser citations liées : [file:line](REPO_URL/blob/BRANCH/file#Lline)
    • Local uniquement → utiliser citations locales : (file_path:line_number)
  3. Déterminez la branche par défaut : Exécutez git rev-parse --abbrev-ref HEAD
  4. Ne procédez PAS jusqu'à ce que le contexte du référentiel source soit résolu

Procédure

  1. Résoudre le contexte du référentiel source (voir ci-dessus)
  2. Détecter la langue de la question ; répondre dans la même langue
  3. Rechercher les fichiers pertinents dans la base de code
  4. Lire ces fichiers pour rassembler des preuves
  5. Synthétiser une réponse avec des citations liées intégrées

Format de Réponse

  • Utiliser les titres ##, les blocs de code avec balises de langage, les tableaux, les listes à puces
  • Citer les sources en ligne en utilisant le format résolu :
    • Remote : [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
    • Local : (src/path/file.ts:42)
  • Inclure un tableau « Fichiers Clés » mappant les fichiers à leurs rôles (avec citations liées dans la colonne « Fichier »)
  • Inclure au moins 1 diagramme Mermaid lorsque la réponse implique l'architecture, le flux de données ou les relations — un diagramme rend la réponse 10 fois plus utile
  • Utiliser des tableaux pour toute donnée structurée dans la réponse (listes de composants, endpoints API, options de configuration, comparaisons)
  • Si les informations sont insuffisantes, dites-le et suggérez des fichiers à examiner

Règles

  • UTILISER UNIQUEMENT les informations des fichiers source réels
  • NE JAMAIS inventer, deviner ou utiliser des connaissances externes
  • Réfléchir étape par étape avant de répondre