Как ставить задачи ИИ-помощнику, чтобы он понял с первого раза

Промпт это текст задания, которое вы даёте нейросети. Для ИИ-помощника по коду это поручение стажёру: чем яснее вы объяснили, что нужно и как понять, что готово, тем меньше недоразумений.

Хороший промпт похож на короткое техническое задание, а не на загадку. Помощник не читает мысли. Он видит только то, что вы написали, и то, что лежит в вашей папке.

Писать можно обычным русским языком, как коллеге в мессенджере. Никаких специальных заклинаний не нужно.

Вы увидите: пока на экране ничего не меняется. Дальше вы составите первое задание по шаблону.

Описывайте задачу тремя частями: что сделать, где именно (какой файл или папка) и как проверить результат. Если нужно, добавьте четвёртую: что трогать нельзя.

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

Что сделать: [одно действие своими словами]
Где: [файл или папка]
Как проверить: [что я должен увидеть, когда всё готово]
Не трогай: [что оставить как есть]

Заполните шаблон для любой маленькой правки в вашей учебной папке. Подойдёт и задача вроде «добавь в README строку про автора».

Вы увидите: четыре короткие строки, которые поместятся на один экран телефона.

Сравните две формулировки одной и той же просьбы. Во второй есть место, действие, граница и проверка.

Вы увидите: в каждой строке «после» можно найти ответ на вопросы «что», «где» и «как проверить».

Чаще всего причина в размытой задаче: не назван файл, не сказано, как понять, что готово, не указаны границы. Помощник достраивает недостающее по догадке, и догадка не всегда ваша.

Помните про рабочий стол помощника: он видит только то, что на нём лежит. Если важное осталось у вас в голове или в другом окне, для него этого не существует.

Что помогает: разбить большую задачу на маленькие шаги, прямо назвать, что трогать нельзя, и приложить нужные факты прямо в задачу.

Вы увидите: вы можете назвать, чего не хватило в вашем последнем неудачном запросе.

Нет. Современные нейросети понимают русский и справляются с русскими задачами. Пишите так, как вам удобнее думать.

Названия файлов, команд и технические слова оставляйте как есть: index.html, npm test, README.md. Их не переводят.

Если результат с русским запросом вас не устроил, сначала уточните саму формулировку: добавьте файл, проверку, границы. Переход на английский пробуйте как отдельный эксперимент, а не как правило.

Длинную задачу можно наговорить голосом и вставить текстом. Это бывает быстрее, чем печатать. Про бесплатный способ есть отдельный гайд ниже.

Вы увидите: ваши задачи можно писать на родном языке.

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

Сначала не меняй файлы. Расскажи в пяти пунктах, как ты будешь решать эту задачу и какие файлы затронешь. Жди моего ответа «давай».

Прочитайте план. Если что-то не так, поправьте прямо в чате. Потом напишите «давай», и помощник приступит к правкам, а после них проверит результат.

Вы увидите: помощник отвечает планом и не трогает файлы, пока вы не разрешите.