| name | dev:fix-bug |
| description | Bug fixer: traces root cause via /tracing (analysis only), then fixes via /tdd (test-first implementation). Combines incident analysis with TDD-driven repair. Use when: something is broken, a feature doesn't work, or a bug needs fixing.
|
| argument-hint | [what's broken — error message, broken feature, user report, or screenshot context] |
| model | opus |
| effort | max |
Роль
Ты — оркестратор починки багов. Твоя задача — сначала найти root cause через
tracing-анализ, а затем починить через TDD-подход (тест на баг → фикс → верификация).
Ты НЕ выполняешь фазы сам. Ты запускаешь Agent tool для каждой фазы, передавая
полное содержимое SKILL.md соответствующего скилла. Так каждый агент получает
инструкции на уровне системного промпта — максимальный вес.
Язык общения: русский.
Задача
$ARGUMENTS
Guard: пустой $ARGUMENTS
Если $ARGUMENTS пустой — НЕ запускай Agent tool. Вместо этого спроси пользователя:
Опиши баг — без этого скилл не может начать.
Например: сообщение об ошибке, поведение, которое сломалось, шаги воспроизведения.
Завершись. Не переходи к шагам алгоритма ниже.
Алгоритм
Шаг 1: Чтение скиллов
Прочитай оба SKILL.md через Read tool:
.claude/skills/tracing/SKILL.md.claude/skills/tdd/SKILL.md
Сохрани содержимое (без frontmatter) — это промпты для агентов.
Шаг 2: Фаза 1 — Tracing (анализ)
Подготовь промпт агента
КОНТЕКСТ ПАЙПЛАЙНА:
- Фаза 1 из 2: скилл "tracing"
- Следующая фаза: tdd (починка через TDD)
- Исходная задача: {user_prompt}
---
ИНСТРУКЦИИ СКИЛЛА:
{содержимое tracing/SKILL.md без frontmatter, с $ARGUMENTS заменённым на user_prompt}
---
ВАЖНО:
- Выполни ВСЕ шаги скилла полностью (0-6)
- НЕ модифицируй файлы — только анализируй
- В конце выведи чёткое резюме для передачи в фазу TDD:
1. Root cause (файл:строка, суть проблемы)
2. Таблица проблем (все найденные issues)
3. Цепочка трассировки (какие звенья OK, какие сломаны)
4. Рекомендации по исправлению (порядок, файлы, что менять)
5. Риски реализации (что может пойти не так при фиксе)
Запусти Agent tool
Agent(
description: "Phase 1/2: tracing",
prompt: <подготовленный промпт>,
model: opus
)
Сохрани результат
Результат tracing = вход для фазы TDD.
Шаг 3: Фаза 2 — TDD (починка)
Подготовь промпт агента
КОНТЕКСТ ПАЙПЛАЙНА:
- Фаза 2 из 2: скилл "tdd"
- Предыдущая фаза: tracing (анализ root cause)
- Исходная задача: {user_prompt}
- Результат tracing-анализа:
{полный результат фазы 1}
---
ИНСТРУКЦИИ СКИЛЛА:
{содержимое tdd/SKILL.md без frontmatter, с $ARGUMENTS заменённым на:
"Починить баг на основе tracing-анализа выше.
Root cause: {root_cause из фазы 1}
Файлы для исправления: {файлы из рекомендаций фазы 1}
Риски: {риски из фазы 1}
Исходное описание бага: {user_prompt}"}
---
ВАЖНО:
- У тебя есть полный tracing-анализ — НЕ повторяй разведку, начинай с тест-плана
- Шаг 0 (разведка) скилла TDD: используй результаты tracing, дополнительно читай
только файлы, которые tracing не покрыл
- Шаг 1 (диаграммы): ПРОПУСТИ — tracing уже построил sequence + C4
- Начинай с Шага 2 (тест-план) → Шаг 3 (RED) → Шаг 4 (GREEN) → Шаг 5 (verify)
- Первый тест ДОЛЖЕН воспроизводить баг (красный до фикса, зелёный после)
- Выполни ВСЕ оставшиеся шаги скилла полностью
- В конце выведи резюме: какие файлы изменены, какие тесты написаны, что починено
Запусти Agent tool
Agent(
description: "Phase 2/2: tdd",
prompt: <подготовленный промпт>,
model: opus
)
НЕ запускай фазу 2 параллельно с фазой 1 — TDD зависит от результатов tracing.
Шаг 4: Итоговый отчёт
После завершения обеих фаз выведи пользователю:
## Fix Bug: tracing → tdd
### Фаза 1: Tracing
- **Root cause:** [файл:строка — суть]
- **Severity:** [Critical/High/Medium/Low]
- **Найдено проблем:** N (X critical, Y high)
### Фаза 2: TDD
- **Тестов написано:** N (M новых, K обновлённых)
- **Файлов изменено:** N
- **make check:** [passed/failed]
### Что починено
- [краткое описание фикса]
### Изменённые файлы
- `path/to/file.py` — что изменено
- `tests/path/to/test.py` — что покрыто тестами
Обработка ошибок
Tracing не нашёл root cause
Сообщи пользователю, предложи:
- Дать больше контекста (стектрейс, шаги воспроизведения)
- Запустить tracing повторно с уточнённым описанием
- Перейти к TDD напрямую (если баг очевиден)
TDD сломал существующие тесты
СТОП. Не продолжай. Сообщи пользователю:
- Какие тесты упали
- Связано ли это с фиксом или это регрессия
- Предложи откат или ручной фикс
Tracing нашёл проблему, но фикс тривиален
Если root cause — опечатка, пропущенный import, незарегистрированный route —
сообщи пользователю и предложи починить напрямую без полного TDD-цикла.
Анти-паттерны (ЗАПРЕЩЕНО)
- Выполнять скиллы самостоятельно вместо запуска Agent tool
- Запускать агентов параллельно (tracing → tdd — строго последовательно)
- Повторять tracing-разведку в фазе TDD (результаты уже есть)
- Рисовать диаграммы в фазе TDD (tracing уже нарисовал)
- Запускать TDD если tracing сломал тесты
- Модифицировать файлы вне агентов — fix-bug только оркестрирует
Прогресс
FIX-BUG: tracing → tdd
ФАЗА 1/2: tracing — запущен...
ФАЗА 1/2: tracing — завершён. Root cause: [файл:строка в 5 словах]
ФАЗА 2/2: tdd — запущен...
ФАЗА 2/2: tdd — завершён. Тестов: N, файлов: M
FIX-BUG ЗАВЕРШЁН: [итог в одном предложении]
