К содержимому
Все материалы

нейросети · продукт

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

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

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

В конце у вас будет карточка своей задачи и список проверок. Шаблон в Markdown можно скачать сразу; промпт самопроверки копируется кнопкой рядом с обложкой. По нему агент составит отчёт: что выполнено, что требует доработки и что осталось проверить.

01

Критерий приёмки описывает готовый результат

Критерий приёмки отвечает на вопрос: по чему я пойму, что задача готова? У него есть исходное условие, действие и наблюдаемый ответ. Я должен знать, где увидеть результат и как повторить проверку.

Возьмём ссылку скачивания в статье. Человек открывает страницу на телефоне, нажимает ссылку и получает файл с шаблоном. Если файл пустой или ссылка ведёт в никуда, задача ещё открыта. Наличие самой ссылки проверяет только часть этого пути.

Просьба агенту

Добавь кнопку скачивания

Понятно, что сделать. Условия готовности ещё предстоит выбрать.

Критерий приёмки

По кнопке приходит нужный файл

Ссылка работает на телефоне, файл непустой и открывается.

Просьба задаёт работу, критерий позволяет принять её результат.

Я разделяю обязательные условия и пожелания. Работающая выдача обязательна; подпись кнопки можно обсудить после просмотра. Для небольшой задачи достаточно нескольких условий, каждое из которых я могу проверить сам. Один пример нужного результата помогает договориться точнее, чем повторение слова «качественно».

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

02

Что записать перед первым запуском

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

  1. Зачем менять: кому и чем мешает нынешнее поведение.
  2. Что получить: один законченный результат для человека.
  3. На чём работать: исходный файл, образец и источник фактов.
  4. Как принять: наблюдаемые условия и способ проверить каждое.
  5. Где остановиться: что агент делает сам и какое решение приносит мне.

У исходных данных должен быть адрес. Для статьи это запись разговора, для отчёта конкретная выгрузка, для монтажа исходный дубль. Если цена хранится в общем каталоге проекта, я указываю каталог. Так агент знает, с чем сверять ответ.

Способ реализации агент может предложить сам. Моя задача: назвать нужное поведение и сослаться на уже принятые решения проекта. В конце я уточняю, достаточно ли показать превью, выполнить локальную сборку или подготовить изменения к публикации.

Если ещё выбираете рабочую среду, начните со сравнения Claude Code и Codex. Карточка пригодится в обоих инструментах: в ней записан результат задачи, а команды запуска зависят от вашего проекта.

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

03

Пример целиком: что я поручил проверить на сайте

5 ноября я поручил проверять собранные страницы по тому, что доступно посетителю. Работа записана в решении 0165 и вошла в принятый PR №202. Ниже карточка, восстановленная по этим документам.

Раньше файл проверки дизайна занимал 677 строк; около 470 читали исходники, включая названия классов и порядок блоков. При изменении дизайна приходилось обновлять и такие проверки. Я выбрал проверку заголовков, ссылок, якорей и файлов готового сайта.

Карточка одной задачи
Зачем
Замечать сломанную страницу до публикации и сохранять проверки при смене оформления.
Результат
Проверка после сборки называет нарушения на готовых страницах.
Исходные данные
Сборка сайта, действующие правила проекта, карта источников переходов.
Критерии приёмки
  1. Один главный заголовок; следующие уровни идут по порядку.
  2. Указан русский язык, масштаб страницы можно увеличить.
  3. Идентификаторы уникальны, у каждого якоря есть цель.
  4. У ссылок и кнопок есть доступные имена; картинки и файлы присутствуют в сборке.
  5. В подвале есть документы и контакты; реквизиты соответствуют общей настройке.
  6. У вопросов о клубе есть ответы, переходы размечены для учёта источника.
Что сохраняем
Карту источников, архитектурные правила и проверки того, чего не видно в готовом HTML.
Что предъявить
Изменения кода и полный прогон проверок репозитория до принятия PR.

Такую карточку можно обсудить до разработки. Видно, какое поведение обязательно, где его искать и что остаётся прежним. Агент получает свободу изменить код внутри этих договорённостей, а я могу принять результат по тому же списку.

04

Как мы приняли результат

Работа была принята по результату сборки и проверке на намеренной поломке. Файл сократился с 677 до 285 строк, проверки перешли на готовые страницы, полный набор проверок репозитория прошёл. PR принят 5 ноября.

Саму проверку мы тоже испытали. В копию сборки подложили страницу с пятью нарушениями: повторным идентификатором, якорем в никуда, ссылкой и кнопкой без подписи, несуществующей картинкой. Новая проверка назвала все пять.

Это даёт основание доверять конкретной проверке. Мы знаем, какие ошибки она замечает, и можем повторить опыт после её изменения. Число строк показывает объём работы; для приёмки я смотрю на обнаруженные нарушения и итоговый прогон.

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

05

Как превратить «сделай хорошо» в условие

Задайте себе вопрос: что я увижу, когда условие выполнено? Ответ должен называть объект и признак, который можно наблюдать. Для сайта это может быть ширина экрана, для таблицы число строк, для бота ответ на команду.

  • Сайт: на 390 пикселях заголовок и кнопка видны целиком, горизонтальной прокрутки нет.
  • Файл: таблица открывается, строки исходной выгрузки сохранены, итог считается по указанному столбцу.
  • Бот: после команды человек получает один ответ с нужным материалом.

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

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

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

06

Как проверить саму проверку

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

Порядок короткий: сохраните рабочую версию, внесите одно нарушение, запустите проверку и прочитайте сообщение. Затем верните исходное состояние и повторите запуск. Два результата покажут, на что реагирует проверка.

Меняется оформление, а ссылки работают? Проверка ссылок должна пройти. Пропала цель якоря? Она должна назвать нарушенную связь. Так вы проверяете именно тот результат, который записан в карточке задачи.

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

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

07

Как скилы помогают пройти задачу по шагам

В моём наборе скилы Мэтта Покока разделяют уточнение, постановку, разработку и ревью. Скил представляет собой сохранённую инструкцию агенту. Каждый нужен в тот момент, когда появляется соответствующая работа.

  • grill-me: агент разбирает неясности, предлагает ответы, доступные факты ищет сам. Решения о желаемом поведении остаются за мной.
  • to-spec: сохраняет договорённости в описании задачи, включая способ проверки через доступный интерфейс. Посетитель сайта может открыть страницу и нажать ссылку.
  • tdd: одна проверка показывает отсутствующий результат, затем агент делает изменение, с которым она проходит. Следующий кусок следует за работающим.
  • code-review: отдельно сверяет правила проекта и соответствие постановке. Нужны оба ответа, чтобы принять работу.

Так я могу обсуждать один работающий шаг, пока изменение ещё невелико. Уточнения остаются в карточке, результат проходит проверку, замечания возвращаются к конкретному условию. При небольшой правке часть этих шагов уже может быть понятна из проекта.

08

Что советует Anthropic для такой работы

Anthropic рекомендует дать агенту способ проверить собственный результат. В рекомендациях по Claude Code предлагаются тесты, ожидаемые ответы и визуальные образцы. Агент делает изменение, получает обратную связь и исправляет его до передачи человеку.

В материале о проверках агентов Anthropic разделяет конечное состояние и рассказ о действиях. В моей задаче это разница между фразой «проверил ссылки» и существующими целями ссылок в собранной странице. Второе можно наблюдать и сверять.

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

В этом порядке человек выбирает, что считать успехом, а агент получает возможность довести работу до этих условий. Обратная связь приходит после каждого запуска. Чем точнее названо расхождение, тем понятнее следующее исправление.

09

Что сохранить в проекте для следующего сеанса

Карточка хранит одну задачу, AGENTS.md хранит постоянные правила, скил хранит процедуру. В моих репозиториях постоянные правила указывают источник названий и цен, команду проверки и порядок выпуска. Агент читает их до работы.

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

Откройте новый сеанс и передайте карточку с правилами проекта. Если продолжить мешает решение, оставшееся в старом чате, сохраните его вместе с причиной. Из такого порядка затем можно собрать автоматизацию повторяющегося процесса.

У такой записи есть ещё одна задача: сохранить причину решения. Следующему сеансу важно понимать, зачем правило появилось и какое поведение оно защищает. Тогда при изменении оформления агент сможет сохранить смысл договорённости, даже если код станет другим.

10

Как задать цель долгому запуску

Долгому запуску нужны предъявляемый результат и условие остановки. Я бы сформулировал итог так: подготовить изменение, выполнить проверки и показать отчёт по обязательным пунктам. Если данных не хватает или нужен мой выбор, агент приносит этот вопрос.

Подготовка занимает время. В посте от 3 июня я рассказывал о запуске 136 агентов параллельно. На подготовку задачи и критериев выполнения ушло около двух часов; запуск отработал хорошо.

В Claude Code команда /goal задаёт условие продолжения работы, которое отдельная модель проверяет по истории сеанса. Для него я бы указывал конкретный итог, например пройденные проверки выбранной задачи. Также стоит назвать разрешённую среду и предел затрат или попыток.

11

Как использовать шаблон и принять свою задачу

Возьмите одну задачу, заполните карточку и передайте её агенту вместе с исходными данными. Скачать шаблон в Markdown: внутри постановка, критерии и форма отчёта. Промпт самопроверки копируется кнопкой рядом с обложкой.

Сначала попросите проверить карточку: понятны ли обязательные результаты и способ приёмки. Затем поручите работу. После выполнения агент заполняет таблицу доказательств по тем же пунктам.

Что должно быть в отчёте
СтатусОснование
ВыполненоЕсть фактическое наблюдение и доказательство: файл, вывод команды или результат ручного просмотра.
Не выполненоНазван критерий и показано расхождение. Понятно, что исправить.
Не провереноУказано, чего не хватает для проверки и какой шаг нужен дальше.

Для доработки верните номер критерия и наблюдаемую ошибку: «Пункт 3: ссылка ведёт на отсутствующий раздел». После исправления повторите связанную проверку. Если изменилось само ожидание, обновите карточку явно.

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

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

12

Что делать, если результат всё ещё не подходит

Опишите расхождение на примере и добавьте недостающее условие. Возможно, критерии покрыли функциональность, но не голос или композицию. Возможно, вы увидели результат и изменили решение.

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

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

13

Границы

Карточка примера восстановлена по решению и принятому PR; запуск всей цепочки скилов на этой задаче историей не подтверждён. Назначение команд описано по моей локальной версии. Дополнительные примеры критериев и экспериментов показывают, как применить метод к своей работе.

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

14

Источники

Все материалы
Оператор открывает один из ящиков большой бумажной мастерской

нейросети · продукт

Claude Code для чего: шесть задач из моей работы

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

Читать разбор

Карточка готова. Пройдите задачу с агентом.
Сначала на учебном проекте с известным ответом.

В методичке «Автоматизации с агентами» вы пройдёте вопросы, спеку, один срез через тест и разбор сбоя. Затем повторите цепочку на своём процессе. Нужны компьютер и Claude Code или Codex.

Посмотреть методичку