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 :
- Vérifier la remote git : Exécutez
git remote get-url originpour détecter si une remote existe - 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)
- URL remote fournie → stocker en tant que
- Déterminer la branche par défaut : Exécutez
git rev-parse --abbrev-ref HEAD - NE PAS continuer tant que le contexte du référentiel source n'est pas résolu
Procédure
- Résoudre le contexte du référentiel source (voir ci-dessus)
- Détecter la langue de la question ; répondre dans la même langue
- Rechercher dans la base de code les fichiers pertinents
- Lire ces fichiers pour rassembler les preuves
- 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)
- Remote :
- 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