Maison

Skill

Productivité et flux de travail

wiki-qa

microsoft/skills

Répond aux questions concernant un dépôt de code en analysant les fichiers source, et fournit des explications étayées par des preuves, accompagnées de références intégrées.

...Développer tout

Heure mise à jour 11 septembre 2026

# documentation # git # codebase qa # mermaid diagrams # source code analysis

Questions-réponses du wiki

Répondez aux questions du référentiel en vous appuyant exclusivement sur des preuves issues du code source.

Quand l'activer

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

Analyse du dépôt source (À FAIRE EN PREMIER)

Avant de répondre à toute question, vous DEVEZ déterminer le contexte du dépôt source :

Vérifier la présence d'un git remote : exécuter git remote get-url origin pour détecter s’il existe un dépôt distant
Demandez à l’utilisateur : « S’agit-il d’un dépôt uniquement local, ou disposez-vous d’une URL de dépôt source (par exemple, GitHub, Azure DevOps) ? »
- URL distante fournie → enregistrer sous forme de REPO_URL, utilisez les références liées : [file:line](REPO_URL/blob/BRANCH/file#Lline)
- Uniquement local → utiliser les références locales : (file_path:line_number)
Déterminer la branche par défaut : exécuter git rev-parse --abbrev-ref HEAD
NE PAS continuer tant que le contexte du dépôt source n’est pas résolu

Procédure

Résoudre le contexte du dépôt source (voir ci-dessus)
Détecter la langue de la question ; répondre dans la même langue
Rechercher les fichiers pertinents dans la base de code
Lire ces fichiers pour rassembler des éléments probants
Synthétiser une réponse avec des citations intégrées et des liens

Format de la réponse

Utiliser des ## des titres, des blocs de code avec des balises de langage, des tableaux et des listes à puces
Citez vos sources dans le texte en utilisant le format « resolved » :
- À distance : [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- Local : (src/path/file.ts:42)
Incluez un tableau « Fichiers clés » mettant en correspondance les fichiers et leurs rôles (avec des citations liées dans la colonne « Fichier »)
Incluez au moins un diagramme Mermaid lorsque la réponse porte sur l’architecture, les flux de données ou les relations — un diagramme rend la réponse 10 fois plus utile
Utilisez des tableaux pour toutes les données structurées de la réponse (listes de composants, points de terminaison API, options de configuration, comparaisons)
Si les informations sont insuffisantes, signalez-le et suggérez des fichiers à consulter

Règles

N’utilisez QUE les informations issues des fichiers sources réels
N’inventez JAMAIS, ne devinez JAMAIS et n’utilisez JAMAIS de connaissances externes
Réfléchissez étape par étape avant de répondre

Voir sur GitHub

---
name: wiki-qa
description: Answers questions about a code repository by analyzing source files, providing evidence-based explanations with inline citations.
license: MIT
---

# Wiki Q&A

Answer repository questions grounded entirely in source code evidence.

## When to Activate

- User asks a question about the codebase
- User wants to understand a specific file, function, or component
- User asks "how does X work" or "where is Y defined"

## Source Repository Resolution (MUST DO FIRST)

Before answering any question, you MUST determine the source repository context:

1. **Check for git remote**: Run `git remote get-url origin` to detect if a remote exists
2. **Ask the user**: _"Is this a local-only repository, or do you have a source repository URL (e.g., GitHub, Azure DevOps)?"_
   - Remote URL provided → store as `REPO_URL`, use **linked citations**: `[file:line](REPO_URL/blob/BRANCH/file#Lline)`
   - Local-only → use **local citations**: `(file_path:line_number)`
3. **Determine default branch**: Run `git rev-parse --abbrev-ref HEAD`
4. **Do NOT proceed** until source repo context is resolved

## Procedure

1. Resolve source repo context (see above)
2. Detect the language of the question; respond in the same language
3. Search the codebase for relevant files
4. Read those files to gather evidence
5. Synthesize an answer with inline linked citations

## Response Format

- Use `##` headings, code blocks with language tags, tables, bullet lists
- Cite sources inline using resolved format:
  - **Remote**: `[src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)`
  - **Local**: `(src/path/file.ts:42)`
- Include a "Key Files" table mapping files to their roles (with linked citations in the "File" column)
- **Include at least 1 Mermaid diagram** when the answer involves architecture, data flow, or relationships — a diagram makes the answer 10x more useful
- **Use tables** for any structured data in the answer (component lists, API endpoints, config options, comparisons)
- If information is insufficient, say so and suggest files to examine

## Rules

- ONLY use information from actual source files
- NEVER invent, guess, or use external knowledge
- Think step by step before answering