«Не работает» — и ИИ начинает гадать, а не чинить…

«Не работает» — и ИИ начинает гадать, а не чинить

Сообщаешь агенту: "код кнопки, что ты прислал, не работает" — и получаешь либо правку наугад, либо исправление совершенно не той проблемы. Дело не в том, что агент плохо справляется с багами — дело в том, что "не работает" не говорит ничего о том, что именно пошло не так.

Что обычно отсутствует в типичном баг-репорте:

— что именно ты делал прямо перед тем, как что-то сломалось
— что ты ожидал увидеть
— что увидел на самом деле
— происходит ли это каждый раз или иногда
— точный текст ошибки, если она была показана

Без этого агент вынужден воспроизводить проблему вслепую — а если не может её воспроизвести, чинит то, что кажется наиболее вероятной причиной, а не то, что реально сломано.

Структура рабочего баг-репорта:

✅Шаги для воспроизведения. "Открываю страницу → нажимаю кнопку "отправить" → ничего не происходит" — агент может повторить твои действия, а не угадывать контекст
✅ Ожидание vs реальность. "Ожидал, что форма отправится и появится сообщение об успехе. Вместо этого — ничего не произошло, страница просто осталась как есть"
✅Точный текст ошибки, если она была — скопируй дословно, не пересказывай своими словами. "Какая-то ошибка про undefined" и реальный текст ошибки — это разная степень полезности для диагностики
✅ Частота. "Происходит каждый раз" и "происходит иногда, не могу понять закономерность" — это разные типы проблем, и вторая обычно сложнее, но сама эта информация уже сужает круг поиска
✅Что изменилось перед этим, если применимо — "было нормально, пока не добавил новое поле в форму" — прямая подсказка, где искать

Пример разницы:

Вместо: "Форма не работает"
Лучше: "Открываю страницу регистрации, заполняю все поля корректными данными, нажимаю "зарегистрироваться". Ожидаю переход на страницу профиля. Вместо этого — страница просто перезагружается, и все поля формы становятся пустыми. В консоли браузера вижу ошибку: [точный текст]. Происходит каждый раз, когда в поле email есть точка после @."

Готовый промпт-заготовка:

Баг: [краткое описание в одном предложении]



Шаги для воспроизведения:

1. [что делаю]

2. [что делаю дальше]

3. [что происходит]



Ожидал: [что должно было произойти]

Получил: [что произошло на самом деле]

Текст ошибки (если есть): [дословно, из консоли/лога]

Частота: [всегда / иногда / только при определённых условиях]

Что менялось перед этим (если применимо): [контекст]



Сначала найди причину и объясни её мне, прежде чем исправлять.

🟣Теги: #вайбкодинг