Промпты для вайбкодинга: как ставить задачи AI-агенту
Практическая структура промпта для Codex, Claude Code и других coding-агентов: контекст, границы задачи, ограничения и проверяемый результат.
Для работы с coding-агентом достаточно пяти частей: цель, контекст проекта, конкретное изменение, ограничения и способ проверки. Сначала попроси агента изучить нужные файлы и предложить план, затем дай разрешение на реализацию одного ограниченного этапа.
Из чего состоит рабочий промпт
Запрос «сделай красиво» оставляет агенту слишком много решений. Он сам выбирает, какой экран менять, какие зависимости добавить и что считать готовым. В результате можно получить заметную переделку, которая не решает исходную задачу.
Рабочий промпт начинается с результата. После него указывается нужная часть проекта, ограничения и проверка. Необязательно писать много: точная задача на десять строк обычно полезнее общего описания на несколько страниц.
- →Что должно измениться для пользователя.
- →В какой странице, компоненте или сервисе работать.
- →Какие существующие решения нужно сохранить.
- →Чего агент не должен добавлять или переделывать.
- →Какими командами и сценариями проверить готовность.
Универсальный шаблон задачи
Начни с формулировки действия: подключить форму к API, исправить мобильную навигацию, добавить сохранение результата или найти причину ошибки. Затем обозначь границы и попроси не менять несвязанные файлы.
Если проект незнаком агенту, раздели работу на два сообщения. В первом он только изучает структуру и предлагает план. Во втором реализует согласованный шаг. Так проще заметить неверное предположение до того, как изменится код.
- →Изучи текущую реализацию и пока ничего не меняй.
- →Опиши причину проблемы и перечисли файлы, которые понадобятся.
- →Предложи минимальный план без смены стека.
- →После подтверждения реализуй только согласованный этап.
- →Запусти проверки и перечисли фактические изменения.
Как продолжать после первого ответа
Не повторяй весь исходный промпт при каждой правке. Ссылайся на конкретный результат: какой блок всё ещё не работает, на какой ширине ломается вёрстка или какой ответ API отличается от ожидаемого.
Если агент несколько раз исправляет последствия собственных изменений, остановись. Верни рабочую версию, уточни исходную причину и начни новый ограниченный шаг. Это быстрее, чем бесконечно дополнять неудачную ветку.
Какие задачи требуют дополнительной проверки
Авторизация, роли, платежи, загрузка файлов и работа с персональными данными нельзя принимать только по сообщению «готово». Попроси агента перечислить модель угроз, проверки доступа и места хранения секретов, а затем проверь сценарии для разных ролей.
API-ключи не вставляют в промпт и не сохраняют в репозитории. Агенту достаточно названия переменной окружения и описания того, где она будет задана при деплое.
Нужны ли специальные магические промпты?
Нет. Качество больше зависит от контекста, границ задачи и понятной проверки, чем от особых формулировок.
Можно попросить агента сделать весь продукт одним запросом?
Можно получить прототип, но его будет сложно проверить и развивать. Для рабочего продукта надёжнее двигаться этапами: интерфейс, данные, API, доступы и деплой.
Связанные материалы
Следующие статьи продолжают тему и помогают выбрать инструменты без привязки к одному бренду.
Хочешь пройти весь маршрут на практике?
В программе эти темы идут не отдельными статьями, а в порядке реальной работы: интерфейс, Codex, backend, данные и публикация.