Heim

Skill

Produktivität und Workflow

wiki-qa

microsoft/skills

Beantwortet Fragen zu einem Code-Repository, indem es Quelldateien analysiert und fundierte Erklärungen mit Inline-Quellenangaben liefert.

...Alle erweitern

Zeit aktualisiert 11. September 2026

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

Wiki-Fragen und Antworten

Beantworten Sie Fragen aus dem Repository, die ausschließlich auf Belegen aus dem Quellcode basieren.

Wann aktivieren?

Ein Benutzer stellt eine Frage zur Codebasis
Der Benutzer möchte eine bestimmte Datei, Funktion oder Komponente verstehen
Der Benutzer fragt: „Wie funktioniert X?“ oder „Wo ist Y definiert?“

Auflösung anhand des Quellcode-Repositorys (MUSS ZUERST ERFOLGEN)

Bevor Sie eine Frage beantworten, MÜSSEN Sie den Kontext des Quell-Repositorys ermitteln:

Auf „git remote“ prüfen: Führen Sie git remote get-url origin aus, um festzustellen, ob ein Remote vorhanden ist
Fragen Sie den Nutzer: „Handelt es sich um ein rein lokales Repository oder haben Sie eine URL für das Quell-Repository (z. B. GitHub, Azure DevOps)?”
- Remote-URL angegeben → speichern als REPO_URL, verknüpfte Verweise verwenden: [file:line](REPO_URL/blob/BRANCH/file#Lline)
- Nur lokal → lokale Verweise verwenden: (file_path:line_number)
Standardzweig ermitteln: Ausführen git rev-parse --abbrev-ref HEAD
Fahren Sie NICHT fort, bis der Kontext des Quell-Repositorys geklärt ist

Vorgehensweise

Kontext des Quell-Repos auflösen (siehe oben)
Erkenne die Sprache der Frage; antworte in derselben Sprache
Durchsuche die Codebasis nach relevanten Dateien
Diese Dateien lesen, um Belege zu sammeln
Eine Antwort mit direkt eingebetteten Quellenangaben zusammenstellen

Antwortformat

Verwenden Sie ## Überschriften, Codeblöcke mit Sprachkennzeichnungen, Tabellen und Aufzählungslisten
Zitieren Sie Quellen inline im „resolved“-Format:
- Extern: [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- Lokal: (src/path/file.ts:42)
Fügen Sie eine Tabelle „Wichtige Dateien“ ein, in der Dateien ihren Funktionen zugeordnet werden (mit verlinkten Quellenangaben in der Spalte „Datei“)
Fügen Sie mindestens ein Mermaid-Diagramm ein, wenn die Antwort Architektur, Datenfluss oder Beziehungen betrifft – ein Diagramm macht die Antwort um das Zehnfache nützlicher
Verwenden Sie Tabellen für alle strukturierten Daten in der Antwort (Komponentenlisten, API-Endpunkte, Konfigurationsoptionen, Vergleiche)
Sollten die Informationen unzureichend sein, weisen Sie darauf hin und schlagen Sie Dateien zur Überprüfung vor

Regeln

Verwenden Sie AUSSCHLIESSLICH Informationen aus den tatsächlichen Quelldateien
Erfinde, rate oder nutze NIEMALS externes Wissen
Gehen Sie Schritt für Schritt vor, bevor Sie antworten

Auf GitHub ansehen

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