К основному содержанию
скилл CX Codex

08-debug — скилл для Claude Code: разбор багов по гипотезам

Скилл 08-debug для разбора багов: воспроизводит известную ошибку вместе с тестом и правкой, а неясную причину ищет перебором гипотез.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-dev@aidd-framework
Открыть на GitHub

Что делает 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-code

3Вручную: положить файлы

~/.claude/skills/08-debug/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/08-debug/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Тесты и QA» →
oma-debug First Fluke Скилл oma-debug для Claude Code и Codex воспроизводит ошибки в кодовой базе, находит первопричину сбоя и готовит точечный патч. Запускается при падении тестов, сбоях в рантайме или плавающих регрессиях. CX Codex +1 ★ 1 472звёзд репо gjalla-debug gjalla Скилл gjalla-debug для поиска первопричины бага с доказательствами до того, как агент предложит исправление. Работает с Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 357установок error-diagnostics-smart-debug sickn33 Скилл error-diagnostics-smart-debug разбирает сбои по шагам воспроизведения, трассировкам, логам и коду, затем помогает проверить гипотезу и зафиксировать исправление. CX Codex +1 1установок om-troubleshooter open-mercato Скилл om-troubleshooter разбирает сбой по симптому: воспроизводит его, находит минимальную первопричину и по запросу правит после теста, который падает до исправления. CX Codex +1 950установок om-root-cause open-mercato Скилл om-root-cause находит причину подтверждённого бага в кодовой базе и готовит краткий план правок для следующего шага автоисправления. Не трогает файлы и работает строго на чтение. CX Codex +1 3 700установок debug-like-expert Lex Christopherson Скилл debug-like-expert активирует протокол методической отладки для сложных ошибок, когда стандартные методы не работают. Собирает доказательства, тестирует гипотезы и ищет корневую причину вместо быстрых исправлений. CX Codex +1 ★ 1 988звёзд репо

Из того же набора80

Весь набор →
02-pull-request Скилл 02-pull-request собирает изменения текущей ветки и открывает черновик pull request или merge request. Запустите его, когда запрос готов к проверке, но ещё не к публикации. CX Codex +1 ★ 571звёзд репо 02-user-stories Скилл 02-user-stories разбирает эпик, бриф или PRD на упорядоченные пользовательские истории с критериями приёмки и проверяет их готовность. CX Codex +1 ★ 571звёзд репо release-video Скилл release-video планирует сцены по вышедшим фичам и собирает готовый видеоролик релиза с музыкой и звуками интерфейса. CX Codex +1 ★ 571звёзд репо 01-acceptance-qa Скилл 01-acceptance-qa для Claude Code проверяет браузерные сценарии по критериям приёмки и записывает видео как доказательство. Проверяет уже рассмотренное изменение. CX Codex +1 ★ 571звёзд репо executor Субагент executor для Claude Code превращает согласованную задачу в проверенный рабочий код проекта. Реализует утверждённый план без самодеятельности. CX Codex +1 ★ 571звёзд репо 02-backlog Скилл 02-backlog для Claude Code ведёт продуктовый бэклог: разбирает запросы, классифицирует элементы, проводит ревью, уточняет задачи и проверяет связи артефактов. CX Codex +1 ★ 571звёзд репо 01-usage Скилл 01-usage отвечает, сколько токенов ушло за период или на одну задачу — по дням, моделям, агентам или тикетам, из локального отчёта aidd telemetry. CX Codex +1 ★ 571звёзд репо 01-sdlc Скилл 01-sdlc для Claude Code ведёт сквозную задачу от постановки до готового драфт-PR через этапы Frame, Deliver и Check. CX Codex +1 ★ 571звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой