/bug-fix

Простым языком

Что-то сломалось — страница падает, кнопка не работает, появилась ошибка. Напиши /bug-fix и опиши проблему или вставь текст ошибки — Claude найдёт причину и починит. Как вызов мастера: описал симптом, он нашёл неисправность, устранил.

Специально для быстрых починок: без длинного планирования, сразу к делу. Claude делает минимально необходимое изменение — не переписывает всё, а точечно фиксирует проблему.

Что делает

/bug-fix переключает Claude в Quick Fix mode: без brainstorm и планирования — сразу к анализу и исправлению. Оптимален для задач на 5-15 минут. Читает логи, локализует проблему, вносит минимальное изменение, пишет тест, коммитит с fix: префиксом.

Синтаксис

# С описанием бага
/bug-fix при открытии /profile падает TypeError

# С ошибкой из логов
/bug-fix TypeError: Cannot read properties of undefined (reading 'avatar')

# Без аргументов — Claude спросит
/bug-fix

Пошаговый процесс

1. Принимает описание бага, ошибку из логов или ссылку на issue
2. Читает стектрейс — определяет файл и строку
3. Анализирует контекст вокруг проблемы (соседние файлы, зависимости)
4. Выдвигает гипотезу и проверяет её через grep по кодовой базе
5. Вносит минимальное изменение — только то, что нужно для фикса
6. Пишет тест который воспроизводит баг и проверяет исправление
7. Коммитит: fix: описание проблемы по Conventional Commits

Примеры использования

TypeError из логов

Пользователь пожаловался что профиль падает. Берёте ошибку из логов и вставляете в /bug-fix.

/bug-fix TypeError: Cannot read properties of undefined (reading 'avatar')
  at ProfileHeader (src/components/ProfileHeader.tsx:34)

# Claude анализирует:
Проблема: user.avatar может быть undefined если не загружен
Строка: <img src={user.avatar.url} />  ← нет проверки

Исправление (минимальное):
<img src={user.avatar?.url ?? '/default-avatar.png'} />

# Тест:
it('не падает при undefined avatar', () => {
  render(<ProfileHeader user={{ ...mockUser, avatar: undefined }} />)
  expect(screen.getByRole('img')).toHaveAttribute('src', '/default-avatar.png')
})

# Коммит: fix: ProfileHeader не падает при отсутствии avatar

Баг с воспроизведением

Знаете шаги воспроизведения но не знаете причину. Claude ищет по кодовой базе где это может происходить.

/bug-fix при фильтрации ленты по тегу "docker" — бесконечный спиннер

# Claude:
Grep: "docker" в контексте фильтров...
Найдено: getFeedPage() не сбрасывает offset при смене тега
Строка 67: offset не обнуляется при изменении filterTag

Исправление:
useEffect(() => {
  setOffset(0)    // добавить эту строку
  setItems([])
}, [filterTag])

Автоматизация

Если коммит с fix: прошёл — CI запускается автоматически. Auto-Fix Pipeline уровня 3: если CI упало — Claude читает логи и делает ещё один фикс-коммит. Максимум 3 попытки, потом git revert.

# Auto-Fix Pipeline для /bug-fix:
/bug-fix → фикс → git commit → git push
  ↓
CI упало → читаем логи → fix-коммит #2
  ↓
CI прошло → деплой автоматически
  ↓
CI снова упало → fix-коммит #3
  ↓
CI снова упало → git revert, сообщаем пользователю

Quick Fix — это не "быстрее написал, быстрее пожалеешь". Это минимальное изменение с максимальной уверенностью.