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

Задача «Перевести настройки на новую форму» выглядит понятной. Агент переводит все вкладки, тесты проходят. А заодно меняет порядок полей на вкладке «Аккаунт», потому что так логичнее, и убирает старую подсказку под паролем.

Ошибки здесь нет. Агент сделал разумную работу, просто не ту, которую от него ждали. Ожидалось, что для пользователя ничего не изменится. Но это было только в голове у того, кто ставил задачу.

Три вещи, которые агент не угадает

Агент хорошо додумывает то, как сделать. Хуже — то, что именно нужно получить и где остановиться. Поэтому в задаче полезно ответить на три вопроса:

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

Та же задача с ожиданиями:

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

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

Где ожидания живут в Tascue

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

Где искать — это поля. «Экран: Настройки» — и агент начинает с нужного места, а не с поиска по всему проекту.

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

Когда результат всё равно не тот

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

Так ожидания остаются рядом с задачей. Через месяц по ней видно не только что сделано, но и что от этого ждали.

Следите за Tascue в LinkedIn