Diagnose

Skill: diagnose

Систематический цикл отладки. Без него легко «починить» симптом, не тронув причину.

Когда применять

Любое из:

• Пользователь говорит «не работает», «упало», «сломалось», «странно ведёт себя».
• Поведение отличается от ожидаемого, но непонятно почему.
• Тест красный и причина не очевидна из стек-трейса.
• После недавнего рефакторинга появилась регрессия.

Когда НЕ применять

• Очевидная опечатка / синтаксическая ошибка — сразу чини.
• Пользователь сам уже назвал причину и просит конкретную правку.
• Задача — добавить фичу, баги нет.

Цикл диагностики (5 шагов)

Делай по одному шагу за раз. Не перепрыгивай.

1. Воспроизведение

Сначала — стабильный repro. Не по слухам, не «иногда».

• Какие точные шаги приводят к багу?
• Какие данные / окружение нужны?
• Если репорт устный — попроси пользователя дать минимальный сценарий.
• Запиши repro в комментарий или в plans/.md блок «Контекст».

Если repro нет — остановись. Без repro отладка превращается в гадание.

2. Минимизация

Урезаем repro до минимума.

• Убрать всё, что не нужно для проявления бага.
• Если баг в форме — попробовать с одним полем.
• Если в API — попробовать минимальным payload.
• Если в UI — попробовать без стилей / без обёрток.

Цель: 5–20 строк, которые ломаются. Маленький repro = быстрый цикл проверки гипотез.

3. Гипотеза

Одна конкретная гипотеза. Не «может быть тут или там».

• «Я думаю это X, потому что Y».
• Проверка: какой эксперимент опровергнет / подтвердит её за 1–2 минуты?

Если гипотез несколько — расставь по приоритету. Проверяй по одной.

4. Инструментирование

Перед правкой — увидеть проблему.

• console.log / print / отладчик / breakpoint.
• Логировать значения в точке, где ожидается одно, а получается другое.
• Если баг в проде — посмотреть Sentry / логи хостинга.
• Не правь «вслепую». Если не видишь причину — добавь логирование, повтори repro, посмотри.

5. Исправление

Только после подтверждённой гипотезы.

• Минимальная правка, которая чинит причину (не симптом).
• Пишем тест, который ловит этот баг (если применимо).
• Прогоняем repro — должно работать.
• Прогоняем соседние сценарии — не сломалось ли что-то рядом (Impact Analysis в миниатюре).
• Убираем добавленные console.log.

Что вернуть пользователю

После исправления — короткий отчёт:

1. Симптом: что наблюдалось.
2. Причина: что на самом деле было сломано (одно предложение).
3. Правка: какой файл / строки изменились (через path:line).
4. Проверка: как убедились что починили (repro теперь зелёный).
5. Регрессия-чек: что рядом проверили на предмет «не сломалось ли».

Антипаттерны

• «Попробую переустановить зависимости» без понимания причины.
• «Закомментирую код, который выкидывает ошибку» — это не починка.
• «Добавлю try/catch для тишины» — это не починка.
• Пять правок одной кнопкой «может теперь сработает».
• Чинить симптом и не написать тест.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Avalon-27reg
• Source: Avalon-27reg/smyslokod-starter
• License: MIT

Install and usage instructions live in the source repository linked above.