wiki-qa — скилл для Claude Code: что делает и как установить
Отвечает на вопросы по кодовой базе строго по файлам проекта, строит Mermaid-диаграммы и даёт ссылки на конкретные строки.
npx skills add microsoft/skills --skill wiki-qa -a claude-codeЧто делает wiki-qa
Скилл заставляет агента отвечать на вопросы о проекте только на основе реальных исходников, исключая любые догадки. Перед ответом помощник определяет контекст репозитория через git remote get-url origin и проверяет ветку через git rev-parse --abbrev-ref HEAD. Если проект привязан к удалённому серверу вроде GitHub, цитаты оформляются кликабельными ссылками на строки. Для локального каталога выводятся пути вида (src/file.ts:42).
В структуру каждого ответа скилл требует включать таблицу ключевых файлов с их назначением, а при описании архитектуры или связей — минимум одну Mermaid-диаграмму. Если информации в коде недостаточно, агент прямо сообщает об этом и советует файлы для ручной проверки. Без настроенного Git или доступа к локальным файлам скилл не сможет сформировать точные ссылки на строки.
Какие задачи решает
- разобраться в устройстве незнакомого репозитория
- найти место объявления функции или компонента
- построить диаграмму связей и потоков данных по коду
- получить ссылки на точные строки исходников без домыслов
Примеры запросов агенту
- Как устроен процесс авторизации пользователей в этом проекте?
- Где объявлен компонент UserProfile и какие пропсы он принимает?
- Покажи архитектуру сервиса платежей с Mermaid-диаграммой
Как установить wiki-qa
1Через Skills CLI (Vercel)
npx skills add microsoft/skills --skill wiki-qa -a claude-code2Вручную: положить файлы
~/.claude/skills/wiki-qa/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/wiki-qa/
Вручную: положить файлы
.agents/skills/wiki-qa/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/wiki-qa/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install microsoft/skills wiki-qa2Вручную: положить файлы
.github/skills/wiki-qa/SKILL.mdКомандой платформы
gemini skills install https://github.com/microsoft/skills --path .github/plugins/deep-wiki/skills/wiki-qaВручную: положить файлы
.devin/skills/wiki-qa/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о wiki-qa
Как установить wiki-qa в Claude Code?
Выполните команду npx skills add microsoft/skills --skill wiki-qa -a claude-code. Также файл скилла можно сохранить вручную в ~/.claude/skills/wiki-qa/SKILL.md.
Что делает wiki-qa?
Он настраивает агента отвечать на вопросы о кодовой базе с опорой только на код проекта, без домыслов. Ответы дополняются таблицами файлов, ссылками на строки и диаграммами Mermaid.
Зачем скилл проверяет git remote перед ответом?
Это нужно для формата ссылок на код. При наличии удалённого адреса агент делает кликабельные веб-ссылки на GitHub или Azure DevOps, а без него оставляет локальные пути к файлам.
Исходный текст
SKILL.md · MIT
--- name: wiki-qa description: Answers questions about a code repository using source file analysis. Use when the user asks a question about how something works, wants to understand a component, or needs help navigating the codebase. license: MIT metadata: author: Microsoft version: "1.0.0" --- # 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
© Microsoft · MIT · microsoft/skills