Как формулировать задачи агенту, чтобы не переделывать
Девять из десяти жалоб на то, что «нейросеть пишет плохой код», — это на самом деле проблема формулировки. Разберём приёмы, которые дают наибольший прирост качества при нулевых затратах.
Шаг 1. Одна задача — один запрос
Формулировка «сделай авторизацию, добавь профиль и почини вёрстку на мобильных» гарантированно даст три посредственных результата вместо одного хорошего. Агент распределяет внимание, и каждая следующая подзадача получает его меньше.
Шаг 2. Запретить угадывать
По умолчанию агент старается быть полезным и додумывает недостающее. Иногда это удобно, но чаще приводит к работе, которую придётся выбросить. Явный запрет угадывать превращает догадку в вопрос.
Если в задаче чего-то не хватает — задай вопрос, не угадывай и не выбирай за меня. Сначала перечисли, что тебе неясно.
Шаг 3. Просить план до правок
Прочитать план на пять строк дешевле, чем разбирать диff на двадцать файлов. Это же ваш шанс поймать неверно понятую задачу до того, как код написан.
Сначала покажи план списком: какие файлы тронешь и что именно изменишь. Код не пиши, жди подтверждения.
Шаг 4. Не просить «почини», просить «объясни»
На сообщение «не работает, почини» агент начинает менять код наугад. Просьба сначала объяснить причину словами включает совсем другой режим работы и часто выявляет, что баг вообще не там, где вы искали.
Вот ошибка: {текст ошибки}.
Сначала объясни причину словами, не правь код.
Потом предложи минимальную правку и скажи,
какие ещё места в проекте она затронет.
Шаг 5. Давать нужные файлы, а не весь проект
Привычка отправлять в контекст весь репозиторий кажется безопасной, но она удорожает работу в разы и ухудшает результат: важное тонет в неважном. Дайте те файлы, которые относятся к задаче, и скажите, где искать остальное.
Шаг 6. Начинать новый диалог чаще, чем кажется нужным
Длинный диалог с неудачными попытками работает против вас: агент видит собственные ошибки как контекст и повторяет их. Если задача забуксовала на третьей итерации — откатитесь и начните заново с более точной формулировкой.