qa-to-issues — скилл для Claude Code: что делает и как установить
Скилл qa-to-issues превращает баг-репорты в готовые задачи на GitHub через диалог. Скилл опрашивает вас, изучает репозиторий и сам публикует тикеты без лишних деталей реализации.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill qa-to-issues -a claude-codeЧто делает qa-to-issues
Скилл запускает интерактивную QA-сессию в диалоге. Вы описываете баг своими словами, а агент задаёт не больше трёх уточняющих вопросов: что ожидалось, как воспроизвести и насколько сбой стабилен. Параллельно в фоне субагент ищет контекст в репозитории и сверяется со словарём предметной области UBIQUITOUS_LANGUAGE.md, если он есть в проекте.
Перед отправкой скилл решает, оформить один тикет или разделить проблему на цепочку независимых задач. В тикетах нет номеров строк и путей к файлам, поэтому описания не устаревают после рефакторинга. Задачи публикуются через утилиту gh issue create сразу, без предварительного согласования черновика.
Без установленной и авторизованной утилиты gh в системе создание задач завершится ошибкой.
Какие задачи решает
- оформить баг-репорт на GitHub прямо из диалога с агентом
- разбить сложную проблему на цепочку независимых тикетов с зависимостями
- составить воспроизводимый сценарий бага в терминах проекта без привязки к путям файлов
Примеры запросов агенту
- Запусти QA-сессию, я нашёл несколько багов в оформлении заказа
- У меня сломалась авторизация через Google, давай оформим тикет
- Хочу завести задачи по результатам ручного тестирования
Как установить qa-to-issues
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill qa-to-issues -a claude-code2Вручную: положить файлы
~/.claude/skills/qa-to-issues/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/qa-to-issues/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill qa-to-issues -a codex2Вручную: положить файлы
.agents/skills/qa-to-issues/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill qa-to-issues -a cursor2Вручную: положить файлы
.cursor/skills/qa-to-issues/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills_disabled/qa-to-issues/SKILL.md2Вручную: положить файлы
.github/skills/qa-to-issues/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill qa-to-issues -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills_disabled/qa-to-issuesВручную: положить файлы
.devin/skills/qa-to-issues/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о qa-to-issues
Как установить qa-to-issues в Claude Code?
Выполните команду npx skills add sammcj/agentic-coding --skill qa-to-issues -a claude-code. Также файл скилла можно положить напрямую по пути ~/.claude/skills/qa-to-issues/SKILL.md.
Зачем qa-to-issues скрывает пути к файлам и строки кода в тикетах?
Скилл формулирует задачи на уровне поведения системы, а не её текущей реализации. Это делает тикеты долговечными: они остаются понятными разработчикам даже после масштабного рефакторинга.
Что нужно настроить перед запуском qa-to-issues?
Для создания задач требуется установленный и авторизованный GitHub CLI (gh). Скилл публикует задачи командой gh issue create и без доступа к репозиторию работать не сможет.
Исходный текст
SKILL.md · Apache-2.0
--- name: qa-to-issues description: Interactive QA session where user reports bugs or issues conversationally, and the agent files GitHub issues. Use when user wants to report bugs in their own codebase and create Github issues conversationally metadata: source: https://github.com/mattpocock/skills --- # QA Session Run an interactive QA session. The user describes problems they're encountering. You clarify, explore the codebase for context, and file GitHub issues that are durable, user-focused, and use the project's domain language. ## For each issue the user raises ### 1. Listen and lightly clarify Let the user describe the problem in their own words. Ask **at most 2-3 short clarifying questions** focused on: - What they expected vs what actually happened - Steps to reproduce (if not obvious) - Whether it's consistent or intermittent Do NOT over-interview. If the description is clear enough to file, move on. ### 2. Explore the codebase in the background While talking to the user, kick off an Agent (subagent_type=Explore) in the background to understand the relevant area. The goal is NOT to find a fix — it's to: - Learn the domain language used in that area (check UBIQUITOUS_LANGUAGE.md) - Understand what the feature is supposed to do - Identify the user-facing behavior boundary This context helps you write a better issue — but the issue itself should NOT reference specific files, line numbers, or internal implementation details. ### 3. Assess scope: single issue or breakdown? Before filing, decide whether this is a **single issue** or needs to be **broken down** into multiple issues. Break down when: - The fix spans multiple independent areas (e.g. "the form validation is wrong AND the success message is missing AND the redirect is broken") - There are clearly separable concerns that different people could work on in parallel - The user describes something that has multiple distinct failure modes or symptoms Keep as a single issue when: - It's one behavior that's wrong in one place - The symptoms are all caused by the same root behavior ### 4. File the GitHub issue(s) Create issues with `gh issue create`. Do NOT ask the user to review first — just file and share URLs. Issues must be **durable** — they should still make sense after major refactors. Write from the user's perspective. #### For a single issue Use this template: ``` ## What happened [Describe the actual behavior the user experienced, in plain language] ## What I expected [Describe the expected behavior] ## Steps to reproduce 1. [Concrete, numbered steps a developer can follow] 2. [Use domain terms from the codebase, not internal module names] 3. [Include relevant inputs, flags, or configuration] ## Additional context [Any extra observations from the user or from codebase exploration that help frame the issue — e.g. "this only happens when using the Docker layer, not the filesystem layer" — use domain language but don't cite files] ``` #### For a breakdown (multiple issues) Create issues in dependency order (blockers first) so you can reference real issue numbers. Use this template for each sub-issue: ``` ## Parent issue #<parent-issue-number> (if you created a tracking issue) or "Reported during QA session" ## What's wrong [Describe this specific behavior problem — just this slice, not the whole report] ## What I expected [Expected behavior for this specific slice] ## Steps to reproduce 1. [Steps specific to THIS issue] ## Blocked by - #<issue-number> (if this issue can't be fixed until another is resolved) Or "None — can start immediately" if no blockers. ## Additional context [Any extra observations relevant to this slice] ``` When creating a breakdown: - **Prefer many thin issues over few thick ones** — each should be independently fixable and verifiable - **Mark blocking relationships honestly** — if issue B genuinely can't be tested until issue A is fixed, say so. If they're independent, mark both as "None — can start immediately" - **Create issues in dependency order** so you can reference real issue numbers in "Blocked by" - **Maximize parallelism** — the goal is that multiple people (or agents) can grab different issues simultaneously #### Rules for all issue bodies - **No file paths or line numbers** — these go stale - **Use the project's domain language** (check UBIQUITOUS_LANGUAGE.md if it exists) - **Describe behaviors, not code** — "the sync service fails to apply the patch" not "applyPatch() throws on line 42" - **Reproduction steps are mandatory** — if you can't determine them, ask the user - **Keep it concise** — a developer should be able to read the issue in 30 seconds After filing, print all issue URLs (with blocking relationships summarized) and ask: "Next issue, or are we done?" ### 5. Continue the session Keep going until the user says they're done. Each issue is independent — don't batch them.
© sammcj · Apache-2.0 · sammcj/agentic-coding