Дом

Skill

Производительность и рабочий процесс

wiki-qa

microsoft/skills

Отвечает на вопросы о репозитории кода, анализируя исходные файлы и предоставляя обоснованные объяснения с указанием источников в тексте.

...Расширить все

Обновлено время 11 сентября 2026 г.

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

Вопросы и ответы в вики

Отвечайте на вопросы из репозитория, основываясь исключительно на доказательствах из исходного кода.

Когда следует активировать

Пользователь задает вопрос о кодовой базе
Пользователь хочет разобраться в конкретном файле, функции или компоненте
Пользователь спрашивает: «Как работает X?» или «Где определено Y?»

Определение контекста исходного репозитория (НЕОБХОДИМО СДЕЛАТЬ В ПЕРВУЮ ОЧЕРЕДЬ)

Прежде чем отвечать на любой вопрос, вы ДОЛЖНЫ определить контекст репозитория исходного кода:

Проверить наличие git remote: запустить git remote get-url origin , чтобы определить наличие удаленного репозитория
Спросите пользователя: «Это исключительно локальный репозиторий или у вас есть URL исходного репозитория (например, GitHub, Azure DevOps)?»
- URL удалённого репозитория указан → сохраните в виде REPO_URL, используйте ссылки на репозитории: [file:line](REPO_URL/blob/BRANCH/file#Lline)
- Только локальный → использовать локальные ссылки: (file_path:line_number)
Определить ветку по умолчанию: Запустить git rev-parse --abbrev-ref HEAD
НЕ продолжайте, пока не будет определён контекст исходного репозитория

Процедура

Определите контекст исходного репозитория (см. выше)
Определить язык вопроса; ответить на том же языке
Выполнить поиск соответствующих файлов в кодовой базе
Прочитать эти файлы для сбора доказательств
Сформировать ответ с встроенными ссылками на источники

Формат ответа

Используйте ## заголовки, блоки кода с тегами языка, таблицы, маркированные списки
Цитируйте источники в тексте, используя установленный формат:
- Удаленные: [src/path/file.ts:42](REPO_URL/blob/BRANCH/src/path/file.ts#L42)
- Локальный: (src/path/file.ts:42)
Включите таблицу «Ключевые файлы», сопоставляющую файлы с их ролями (с ссылками на цитаты в столбце «Файл»)
Включите как минимум 1 диаграмму Mermaid, если ответ касается архитектуры, потока данных или взаимосвязей — диаграмма делает ответ в 10 раз полезнее
Используйте таблицы для любых структурированных данных в ответе (списки компонентов, конечные точки API, параметры конфигурации, сравнения)
Если информации недостаточно, укажите это и предложите файлы для изучения

Правила

Используйте ИСКЛЮЧИТЕЛЬНО информацию из реальных исходных файлов
НИКОГДА не выдумывайте, не гадайте и не используйте знания из внешних источников
Прежде чем отвечать, продумайте каждый шаг

Посмотреть на 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