Обложка статьи: Как ставить задачу ИИ-агенту: рабочий шаблон для начинающего
Обложка статьи: Как ставить задачу ИИ-агенту: рабочий шаблон для начинающего

Как ставить задачу ИИ-агенту: рабочий шаблон для начинающего

Как ставить задачу ИИ-агенту: рабочий шаблон для начинающего

Новички часто думают, что проблема в модели: «она не понимает», «она делает странно», «она опять ушла не туда». На практике в половине случаев проблема не в модели, а в постановке задачи.

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

Почему расплывчатые запросы почти всегда дают расплывчатый результат

Сравните два варианта.

Плохой запрос

Сделай мне сайт для курса.

Что здесь неясно:

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

Нормальный запрос

Нужна одна страница курса. На ней должны быть: hero, программа, блок «для кого», FAQ и форма заявки. Без личного кабинета и без оплаты. Главная цель страницы — оставить заявку. Сначала предложи структуру, потом переходи к вёрстке.

Во втором варианте агенту уже не нужно угадывать границы.

Рабочий шаблон постановки задачи

Используйте шесть блоков. Этого достаточно для большинства задач новичка.

1. Контекст

Коротко объясните, что это за проект.

Пример:

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

2. Цель

Опишите, что должно получиться на выходе.

Нужна одна работающая страница с понятной структурой и формой заявки.

3. Границы

Очень важный блок. Здесь вы пишете, чего делать не надо.

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

4. Критерий готовности

Это ответ на вопрос: как я пойму, что задача выполнена.

Страница открывается без ошибок, хорошо выглядит на телефоне, форма видна, тексты читаются, основные блоки на месте.

5. Порядок работы

Если задача не совсем маленькая, скажите агенту, в каком порядке двигаться.

Сначала покажи структуру и блоки. После этого переходи к вёрстке. Затем отдельно проверь мобильную версию.

6. Формат ответа

Это особенно полезно для новичков.

Поясняй, что ты меняешь и почему. Если есть спорные места, сначала перечисли варианты.

Готовый шаблон, который можно копировать

Контекст: [что это за проект и для кого].

Цель: [какой конкретный результат нужен].

Что обязательно должно быть: [список].

Что сейчас не делаем: [список ограничений].

Критерий готовности: [как понять, что задача завершена].

Порядок работы: [сначала это, потом это].

Формат ответа: [нужен план / краткие комментарии / пошаговые изменения].

Даже если заполнить этот шаблон на 60–70%, результат обычно становится заметно лучше.

Два практических примера

Пример 1. Лендинг

Контекст: это одностраничный сайт курса для новичков.

Цель: собрать читаемую страницу с фокусом на заявке.

Что обязательно: hero, преимущества, программа, FAQ, форма.

Не делаем: оплату, личный кабинет, несколько страниц, блог.

Критерий готовности: страница без ошибок открывается на мобильном и десктопе.

Порядок работы: сначала структура, потом вёрстка, потом мобильная адаптация.

Пример 2. Исправление ошибки

Контекст: есть страница курса, на мобильной версии сломался hero-визуал.

Цель: сделать мобильную версию визуала такой же по логике, как на десктопе.

Что обязательно: сохранить фирменный цвет, положение глаз и размеры символа.

Не делаем: не менять десктопную геометрию, не переписывать весь hero.

Критерий готовности: мобильный символ не пропадает, не меняет цвет и не теряет глаза.

Порядок работы: сначала найди конфликтующие стили, потом предложи минимальный фикс.

Это уже не «магическое пожелание», а нормальное техническое задание в короткой форме.

Что чаще всего ломает результат

Слишком много задач в одном запросе

Если вы просите одновременно:

  • придумать структуру;
  • написать тексты;
  • сверстать;
  • подключить форму;
  • сделать аналитику;
  • настроить оплату;
  • запустить на прод;

то агент почти наверняка потеряет фокус.

Отсутствие ограничений

Если не сказать «не делай оплату» или «не трогай десктоп», агент вполне может начать это делать. Не потому что он плохой, а потому что вы не обозначили рамки.

Непроверяемый результат

Фраза «сделай красиво» плоха тем, что у неё нет чёткой проверки. Лучше писать: «сделай аккуратно, читаемо, без перегруза, с нормальной мобильной версией».

Как просить агента думать аккуратнее

Для начинающего особенно полезны три фразы:

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

Эти фразы не делают модель умнее. Они делают ход работы безопаснее и прозрачнее.

Вывод

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

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

Где следить дальше

Быстрые разборы, новые инструменты и свежие наблюдения я публикую в Telegram: t.me/il_chum

Источники

  • https://openai.com/academy/codex/
  • https://developers.openai.com/codex/cli
  • https://code.claude.com/docs/en/common-workflows