Как написать промпт для ИИ-агента с первого раза

Что такое промпт простыми словами

Звонишь курьеру и говоришь одно слово: «еду». Что он привезёт? Да что угодно. Может, борщ. Может, суши. Может, корм для кота. И не подкопаешься - ты же сам сказал «еду». Курьер не телепат.

С ИИ-агентом - один в один. Он не угадывает, чего ты хочешь. Он делает то, что ты написал. Сформулировал расплывчато - агент сам заполнит пробелы. На свой вкус. А вкус у него свой, и совпадает с твоим он редко.

Почему промпт - главный навык вайбкодера

Ты вайбкодер. Код руками ты не пишешь - ты ставишь задачи словами. Значит, промпт - твой главный инструмент. По сути, единственный. Криво сформулировал - криво получил. Как с гитарой: инструмент один и тот же, а звук зависит от того, кто за него взялся.

Что тебе даёт чёткий промпт:

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

Разница между «ИИ написал какую-то дичь» и «ИИ написал ровно что надо» - это почти всегда один абзац текста, который ты ему скормил. Разберём, из чего этот абзац собирается.

Четыре вопроса хорошего промпта: ЧТО, ГДЕ, ГОТОВО, НЕЛЬЗЯ

Любой рабочий промпт заранее отвечает агенту на четыре вопроса. Не ответишь ты - ответит он. За тебя и на свой лад. Запомни их короткой формулой: «ЧТО - ГДЕ - ГОТОВО - НЕЛЬЗЯ».

ЧТО сделать: формулируем задачу конкретно

Казалось бы, самое очевидное. И всё равно тут косячат чаще всего. «Сделай кнопку» - это не задача. Кнопку чего? Где? Какую? Чем конкретнее глагол и объект, тем меньше места для фантазии у агента.

• Плохо: «улучши сайт»
• Хорошо: «добавь на главную страницу кнопку «Записаться»; по клику открывается форма с полями имя и телефон»

ГДЕ сделать: укажи файл, страницу, контекст

Агент не знает твой проект так, как знаешь его ты. Скажи, в каком файле, на какой странице, рядом с чем. Иначе он либо начнёт искать наугад, либо налепит что-то новое вместо того, чтобы поправить существующее.

ГОТОВО: опиши критерий приёмки результата

Это критерий приёмки Критерий приёмки - простое описание того, как ты поймёшь, что задача сделана правильно. Например: «кнопка синяя, по клику открывается форма, на телефоне ничего не съезжает». . Опиши результат глазами обычного человека: что я должен увидеть на экране, чтобы сказать «да, готово». Нет критерия - агент сам решит, что считать готовым. И его планка вряд ли совпадёт с твоей.

НЕЛЬЗЯ: задай границы, чего НЕ трогать

Самый недооценённый пункт. Агент - старательный отличник. Дай ему волю - и он «заодно» перепишет половину проекта, «потому что так лучше». Скажи прямо, чего трогать нельзя: «не меняй другие страницы», «не переписывай то, что уже работает», «не добавляй новых библиотек».

Чёткий промпт против расплывчатого: сравнение

Пример промпта: было и стало

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

Где прокол? Ты ответил только на вопрос ЧТО - да и то размыто, словом «нормальную». На ГДЕ, ГОТОВО, НЕЛЬЗЯ агент ответил за тебя сам. И промахнулся по всем трём.

А теперь тот же запрос, но по схеме «ЧТО - ГДЕ - ГОТОВО - НЕЛЬЗЯ»:

Добавь форму обратной связи на страницу контактов.
ЧТО: форма с тремя полями - имя, email, сообщение - и кнопкой «Отправить».
ГДЕ: на странице контактов, под текстом с адресом. Найди нужный файл сам, а если не уверен - спроси.
ГОТОВО: на экране видна форма из трёх полей и кнопки. Если нажать «Отправить» с пустыми полями - появляется подсказка «заполни поля». На телефоне форма не съезжает за край.
НЕЛЬЗЯ: не меняй другие страницы, не трогай шапку и меню, не добавляй новые библиотеки без моего разрешения.

Чек-лист: как проверить промпт перед отправкой

Есть простой приём. Перед отправкой прочитай промпт глазами агента, который про тебя и твой проект не знает ровным счётом ничего. Не можешь ответить на какой-то вопрос прямо из текста? Это дырка. И агент заткнёт её сам.

Прогони запрос по мини-чек-листу - по сути, ровно это делает скилл prompt-optimizer, когда выискивает в запросе недостающий контекст:

1. Понятно, ЧТО именно сделать? Конкретный объект и действие, а не «улучшить».
2. Понятно, ГДЕ? Файл, страница, место - или хотя бы разрешение поискать.
3. Понятно, что считать ГОТОВЫМ? Что именно я увижу на экране.
4. Сказано, чего НЕЛЬЗЯ? Границы, что не трогать.
5. Задача не великовата? Если в одном промпте «сделай магазин» - режь на куски.

Частые ошибки в промптах для ИИ

• Слова-резинки. «Красиво», «нормально», «современно», «получше» - каждый понимает по-своему. Агент тоже. Меняй на конкретику.
• Молчание про место. Не сказал где - агент гадает или плодит новое вместо правок.
• Нет критерия готовности. «Готово» по версии агента и «готово» по твоей - это два разных «готово».
• Забыл про границы. Самая болезненная: агент «заодно» переделывает и ломает рабочее.
• Гигантская задача одним промптом. «Сделай мне соцсеть» агент проглотит, но подавится. Режь на шаги.
• Отправил, не перечитав. 30 секунд на вычитку экономят полчаса переделок. Честная сделка.