Lar

Skill

Produtividade e fluxo de trabalho

wiki-qa

microsoft/skills

Responde a perguntas sobre um repositório de código, analisando arquivos-fonte e fornecendo explicações baseadas em evidências com citações no texto.

...Expandir tudo

Tempo atualizado 11 de Setembro de 2026

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

Perguntas e respostas da Wiki

Responda às perguntas do repositório com base exclusivamente em evidências do código-fonte.

Quando ativar

O usuário faz uma pergunta sobre a base de código
O usuário quer entender um arquivo, função ou componente específico
O usuário pergunta “como X funciona” ou “onde Y está definido”

Resolução no repositório de código-fonte (É OBRIGATÓRIO FAZER ISSO PRIMEIRO)

Antes de responder a qualquer pergunta, você DEVE determinar o contexto do repositório de origem:

Verifique se há um git remote: execute git remote get-url origin para detectar se existe um remoto
Pergunte ao usuário: “Este é um repositório apenas local ou você tem uma URL do repositório de origem (por exemplo, GitHub, Azure DevOps)?”
- URL remota fornecida → salve como REPO_URL, use citações vinculadas: [file:line](REPO_URL/blob/BRANCH/file#Lline)
- Somente local → use citações locais: (file_path:line_number)
Determinar o branch padrão: Executar git rev-parse --abbrev-ref HEAD
NÃO prossiga até que o contexto do repositório de origem seja resolvido

Procedimento

Resolva o contexto do repositório de origem (veja acima)
Detecte o idioma da pergunta; responda no mesmo idioma
Pesquise na base de código por arquivos relevantes
Leia esses arquivos para reunir evidências
Sintetizar uma resposta com citações vinculadas no texto

Formato da resposta

Use ## títulos, blocos de código com tags de linguagem, tabelas e listas com marcadores
Cite as fontes no texto usando o formato resolvido:
- Remota: [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- Local: (src/path/file.ts:42)
Inclua uma tabela “Arquivos Principais” mapeando os arquivos às suas funções (com citações vinculadas na coluna “Arquivo”)
Inclua pelo menos 1 diagrama Mermaid quando a resposta envolver arquitetura, fluxo de dados ou relações — um diagrama torna a resposta 10 vezes mais útil
Use tabelas para quaisquer dados estruturados na resposta (listas de componentes, endpoints de API, opções de configuração, comparações)
Se as informações forem insuficientes, mencione isso e sugira arquivos a serem examinados

Regras

Use APENAS informações dos arquivos-fonte reais
NUNCA invente, adivinhe ou use conhecimento externo
Pense passo a passo antes de responder

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