wiki-qa

Répond aux questions sur un dépôt de code en analysant les fichiers source. À utiliser lorsque l'utilisateur pose une question sur le fonctionnement d'un élément, souhaite comprendre un composant ou a besoin d'aide pour naviguer dans le code.

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

Wiki Q&A

Répondez aux questions sur le référentiel en vous appuyant entièrement sur des preuves du code source.

Quand activer

  • L'utilisateur pose une question sur la base de code
  • L'utilisateur veut comprendre un fichier, une fonction ou un composant spécifique
  • L'utilisateur demande « comment fonctionne X » 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érifier la remote git : Exécutez git remote get-url origin pour détecter si une remote existe
  2. Demander à l'utilisateur : « Est-ce un référentiel local uniquement, ou avez-vous une URL de référentiel source (par exemple GitHub, Azure DevOps) ? »
    • URL remote fournie → stocker en tant que REPO_URL, utiliser les citations liées : [file:line](REPO_URL/blob/BRANCH/file#Lline)
    • Local uniquement → utiliser les citations locales : (file_path:line_number)
  3. Déterminer la branche par défaut : Exécutez git rev-parse --abbrev-ref HEAD
  4. NE PAS continuer tant que le contexte du référentiel source n'est pas 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 dans la base de code les fichiers pertinents
  4. Lire ces fichiers pour rassembler les preuves
  5. Synthétiser une réponse avec des citations liées en ligne

Format de réponse

  • Utiliser des titres ##, des blocs de code avec étiquettes de langage, des tableaux, des 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 quand 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 d'API, options de configuration, comparaisons)
  • Si l'information est insuffisante, le dire et suggérer les fichiers à examiner

Règles

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

Skills similaires