Промпты для вайбкодинга — рецепт задачи, после которой ИИ-агент не уходит в сторону
Содержание
Хороший промпт для вайбкодинга состоит из четырёх ингредиентов:
- Цель — что должно получиться.
- Контекст — где и на чём работаем.
- Границы — что трогать нельзя.
- Критерий готовности — как понять, что задача сделана.
Без цели агент делает «что-то похожее». Без границ — лишнее. А без критерия готовности не может проверить себя сам. Магические слова не нужны: агенту важна ясность.
Плохой и хороший промпт
Плохо:
Сделай бота для кружков
Хорошо:
Цель: Telegram-бот, который превращает присланное видео в кружок.
Контекст: Python, папка VideoBot, файл .env с BOT_TOKEN уже есть.
Границы: не меняй .env, не добавляй платные сервисы, видео длиннее 60 секунд отклоняй.
Готово, когда: я отправляю видео и получаю кружок одним ответом. Покажи, как проверить.
Разница не в длине, а в том, что во втором варианте агенту не нужно угадывать.
Семь шаблонов на каждый день
1. План вместо кода
Опиши план в PLAN.md: какие файлы создашь, что в каждом, как проверить. Код пока не пиши.
2. Одна функция
Добавь [функцию]. Меняй только [файлы]. Готово, когда [наблюдаемый результат]. Покажи, как проверить.
3. Ошибка
Делаю [действие], ожидаю [результат], вижу [что на самом деле, текст ошибки целиком].
Найди причину, а не замазывай симптом. Сначала объясни причину, потом исправь.
4. Проверка перед выкладкой
Проверь проект перед запуском: секреты в коде, доступ к чужим данным, что будет при ошибке оплаты.
Ничего не меняй — дай список проблем по важности.
5. Объяснение
Объясни простыми словами, как устроен этот проект: какие части, как они связаны, где хранятся данные.
6. Память проекта
Обнови AGENTS.md: что сделано, как устроен проект, как запускать и проверять. Коротко.
7. Выкладка
Подготовь проект к запуску на сервере. Объясни по шагам, что мне сделать руками, а что сделаешь ты.
Пять правил, которые экономят лимит
- Одна задача — один промпт. «Сделай А, Б и ещё В» — путь к ошибкам.
- Называйте файлы. «Измени bot.py» точнее, чем «где-то там».
- Копируйте ошибку целиком. Пересказ «что-то не работает» стоит агенту лишних попыток.
- Просите объяснить причину. Иначе агент может «исправить», просто спрятав ошибку.
- Проверяйте сами перед следующим шагом.
Скиллы — промпты, которые не надо повторять
Если вы в пятый раз вставляете одну и ту же инструкцию, превратите её в скилл. Это файл, который агент подключает сам, когда задача подходит. Как это сделать в разных агентах — в статьях «Скиллы Claude Code» и «Скиллы для Codex и OpenCode».
Где попробовать
Бесплатно — в OpenCode или Codex. Хорошая первая задача — приложение без кода или Telegram-бот.
Больше шаблонов — в канале
Свои рабочие промпты и скиллы, которыми я собираю ботов и сервисы, публикую в Telegram-канале. Там же анонсы курсов по вайбкодингу.
Частые вопросы
Как правильно писать промпты для вайбкодинга?
Укажите цель, контекст, границы и критерий готовности. Тогда агенту не нужно угадывать, и он может сам проверить результат.
Нужно ли писать промпты на английском?
Не обязательно: современные агенты хорошо понимают русский. Важнее ясность задачи, чем язык.
Почему ИИ-агент делает не то, что я просил?
Чаще всего задача слишком общая или в ней нет границ и критерия готовности. Сформулируйте, что должно получиться и как это проверить.
Как описать ошибку агенту?
Что делали, что ожидали, что увидели, и полный текст ошибки. Попросите сначала объяснить причину, а потом исправить.
Что делать с промптами, которые повторяются?
Превратите их в скилл — файл SKILL.md, который агент подключает сам, когда задача подходит.
