Hogar

Skill

Productividad y flujo de trabajo

wiki-qa

microsoft/skills

Responde a preguntas sobre un repositorio de código mediante el análisis de los archivos fuente, ofreciendo explicaciones basadas en pruebas con citas en el texto.

...Expandir todo

Tiempo actualizado 11 de septiembre de 2026

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

Preguntas y respuestas de la wiki

Responde a las preguntas del repositorio basándote exclusivamente en pruebas del código fuente.

Cuándo activarlo

El usuario formula una pregunta sobre el código fuente
El usuario quiere entender un archivo, una función o un componente concreto
El usuario pregunta «¿cómo funciona X?» o «¿dónde se define Y?»

Resolución basada en el repositorio de código fuente (SE DEBE HACER PRIMERO)

Antes de responder a cualquier pregunta, DEBES determinar el contexto del repositorio de código fuente:

Comprueba si hay un git remote: ejecuta git remote get-url origin para detectar si existe un remoto
Pregunta al usuario: «¿Se trata de un repositorio solo local o tienes una URL del repositorio de código fuente (p. ej., GitHub, Azure DevOps)?»
- Si se proporciona una URL remota → guárdala como REPO_URL, utiliza citas enlazadas: [file:line](REPO_URL/blob/BRANCH/file#Lline)
- Solo local → utilizar referencias locales: (file_path:line_number)
Determinar la rama predeterminada: Ejecutar git rev-parse --abbrev-ref HEAD
NO continúe hasta que se haya resuelto el contexto del repositorio de origen

Procedimiento

Resolver el contexto del repositorio de origen (véase más arriba)
Detectar el idioma de la pregunta; responder en el mismo idioma
Buscar en el código fuente los archivos relevantes
Lee esos archivos para recabar pruebas
Elaborar una respuesta con citas enlazadas en el texto

Formato de la respuesta

Utiliza ## encabezados, bloques de código con etiquetas de lenguaje, tablas y listas con viñetas
Cita las fuentes en el texto utilizando el formato resuelto:
- Remota: [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- Local: (src/path/file.ts:42)
Incluye una tabla de «Archivos clave» que relacione los archivos con sus funciones (con citas enlazadas en la columna «Archivo»)
Incluye al menos un diagrama de Mermaid cuando la respuesta implique arquitectura, flujo de datos o relaciones; un diagrama hace que la respuesta sea 10 veces más útil
Utiliza tablas para cualquier dato estructurado de la respuesta (listas de componentes, puntos finales de la API, opciones de configuración, comparativas)
Si la información es insuficiente, indícalo y sugiere archivos que se puedan consultar

Normas

Utiliza ÚNICAMENTE información procedente de los archivos fuente reales.
NUNCA inventes, adivines ni utilices conocimientos externos
Piensa paso a paso antes de responder

Ver en 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