08-debug — скилл для Claude Code: разбор багов по гипотезам
Скилл 08-debug для разбора багов: воспроизводит известную ошибку вместе с тестом и правкой, а неясную причину ищет перебором гипотез.
MIT ★ 571 обновлён 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-dev@aidd-frameworkЧто делает 08-debug
Скилл ведёт разбор бага по одному из трёх маршрутов. 01 reproduce берёт известную ошибку целиком: воспроизведение, фикс через тест, ветка и PR. 02 debug нужен, когда причина непонятна: скилл выписывает гипотезы и проверяет их по очереди, пока не останется подтверждённая. 03 reflect-issue включается после провалившихся попыток: поиск открывают заново и сначала добавляют логи.
Маршрут выбирается по формулировке: «воспроизведи и почини» уходит в 01, «почему так происходит» в 02, «я застрял» в 03. Действие по умолчанию не подставляется — при неясной просьбе скилл задаст один вопрос. За запуск выполняется только одно действие, и перед работой он читает файл этого действия в actions/, а не таблицу.
Гипотезы складываются в assets/task-template.md. Диагностические действия останавливаются на подтверждённой причине, так что без доказанной причины правки не будет: это отсекает лечение симптомов. Фикс ограничен своим багом, попутные рефакторинги в него не попадают.
Какие задачи решает
- воспроизвести баг и закрыть его тестом вместе с правкой
- найти причину поломки перебором гипотез
- перезапустить расследование, которое застряло
- свести гипотезы в один файл
assets/task-template.md - удержать фикс в границах одного бага
Примеры запросов агенту
- Воспроизведи баг: сохранение формы отдаёт 500, почини и закрой тестом.
- Почему сборка падает после обновления зависимостей?
- Я застрял: прошлые фиксы не помогли, разбери проблему заново.
Как установить 08-debug
1Через маркетплейс плагинов
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-dev@aidd-frameworkКоманда ставит плагин aidd-dev целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 08-debug -a claude-code3Вручную: положить файлы
~/.claude/skills/08-debug/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/08-debug/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 08-debug -a codex2Вручную: положить файлы
.agents/skills/08-debug/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 08-debug -a cursor2Вручную: положить файлы
.cursor/skills/08-debug/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-dev/skills/08-debug2Вручную: положить файлы
.github/skills/08-debug/SKILL.md1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 08-debug -a gemini-cli2Командой платформы
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-dev/skills/08-debugВручную: положить файлы
.devin/skills/08-debug/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 08-debug -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 08-debug
Как установить 08-debug в Claude Code?
Через маркетплейс: сначала /plugin marketplace add ai-driven-dev/framework, затем /plugin install aidd-dev@aidd-framework.
Что делает скилл 08-debug?
Разбирает баги тремя действиями: воспроизведение с фиксом, поиск причины через гипотезы и перезапуск застрявшего расследования. Работает по файлам действий в actions/.
Чем debug отличается от reproduce?
01 reproduce нужен для известной ошибки, которую надо закрыть целиком. 02 debug включается, когда причина неясна: он проверяет гипотезы и останавливается на подтверждённой.
Исходный текст
SKILL.md · MIT
--- name: 08-debug description: Reproduce and fix a known bug, or find an unknown root cause by hypothesis validation. Use when the user wants to fix a bug, find why something breaks, or reopen a stuck investigation. Not for building a feature or reviewing a diff. argument-hint: bug | symptom --- # Skill: debug Diagnose and fix issues through structured hypothesis validation, root-cause analysis, and a test-driven fix. ## Actions | # | Action | When to use | | --- | --------------- | ----------------------------------------------------------------------------- | | 01 | `reproduce` | A known bug must be fixed end to end: reproduce, test-driven fix, branch, PR | | 02 | `debug` | Root cause unknown: enumerate hypotheses, validate each, confirm the cause | | 03 | `reflect-issue` | Stuck or prior fixes failed: reopen the search space, instrument logs first | Pick the one action matching the intent; never default to `01`. Triggers like "reproduce and fix" route to `01`, "why does this happen" to `02`, "I'm stuck" or "previous fixes didn't work" to `03`. Ask one question when the intent is ambiguous. Before running an action, read its file in `actions/`, not only the table or assets. ## Transversal rules - One action per run: follow only the matching action file. - Scope each fix to its bug: never bundle drive-by refactors. - Confirm the root cause before fixing; the diagnostic actions stop at a confirmed cause. ## Assets - `assets/task-template.md`: the per-hypothesis tracking file the debug action fills. ## References - `references/mermaid-conventions.md`: the project's Mermaid conventions for the action-path flowchart.
© AI-Driven Dev · MIT · ai-driven-dev/framework