Содержание статьи
Коротко
- Одна задача — одно ТЗ.
- Нужны цель, файлы, проверка и запреты.
- Без запретов модель правит лишнее.
- Файл лежит в репозитории.
Пустое «сделай хорошо» агент закрывает фантазией. Я пишу короткое ТЗ на одну задачу и кладу его в репозиторий. Любая следующая модель читает тот же файл. Бан одного аккаунта не стирает процесс.
Из чего состоит
На одну задачу хватает экрана. Простыня на весь сайт агент читает выборочно и правит то, до чего дошёл.
В канале пишу то, что не доезжает до статьи.Короткие заметки и тесты нейросетей
Читать канал- Цель в одном предложении. Что должно измениться, а не «улучши проект».
- Какие файлы можно менять. Путь к файлу, не «нужные шаблоны».
- Шаги, если порядок важен. Если порядок не важен, шаги не пишу. Иначе модель изображает процесс.
- Как проверить, что готово. Страница открывается, в diff нет лишних файлов, проверка из ТЗ проходит. Без этого «готово» означает «модель так решила».
- Что не трогать. Прод, чужие сайты, оплаты, чужие тексты, зависимости, которых я не просил.
Как выглядит файл
Держу это обычным markdown. Ниже каркас. В скобках подставляется задача, не общие слова.
# ЗадачаОдним предложением: что изменить.# Можно менять- путь/к/файлу# Нельзя- не выкладывать на прод- не придумывать цифры- не трогать оплату и чужие сайты# Готово, когда- в diff только файлы из списка- страница открываетсяПример запрета
В ТЗ на этот блог прямо сказано: не ставить тему на прод, не придумывать цифры дохода, не рекламировать обход блокировок. Без этой строки модель легко улучшает то, что улучшать нельзя: допишет выручку, поставит пример чужой рекламы, полезет в боевые файлы.
Если статья попала в точку, в канале есть продолжение.Без рассылки на почту, только Telegram
ПодписатьсяЗапрет должен быть конкретной строкой. «Будь аккуратен» не работает. «Не публикуй цифру дохода, если её нет в ТЗ» работает.
Как проверяю ответ
ТЗ без проверки — пожелание. После ответа делаю три вещи.
- Смотрю список файлов. Лишний файл — задача не закрыта, даже если код выглядит прилично.
- Ищу цифры, которых не было во входе. Нашёл — вычёркиваю. Для модели это не аргумент.
- Открываю то, что должно измениться. Отчёту «я всё сделал» не верю.
На коде тот же порядок разобран длиннее: как проверить код, написанный нейросетью. На сравнении моделей смотрел, кто удерживается в этих рамках: Grok, ChatGPT или Claude. Победителя там нет.
Где хранить
Рядом с кодом, не в закладках чата. Один файл на задачу, имя по делу. Тогда запасной агент подхватывает работу без истории прошлого аккаунта.
Короткая версия промптов лежит в боте, в материале к этой статье. Рабочий набор шаблонов, которым пользуюсь сам, — в паке промптов. Это файлы, не курс и не обещание, что агент перестанет ошибаться.
Частые вопросы
Насколько длинным делать ТЗ?
На одну задачу хватает экрана. Простыня на весь сайт агент читает выборочно.
Где взять шаблон?
Короткая версия в боте, рабочий набор — в паке промптов.
Пак промптов и ТЗ для Grok
Промпты и шаблоны ТЗ, которыми пользуюсь каждый день.