Инклюды: как перестать повторять агенту одно и то же
Кто давно работает с ИИ-агентом, знает эти фразы наизусть. «Не делай коммиты». «Сначала воспроизведи ошибку». «В конце коротко напиши, что изменил». Мы писали их в каждом промпте, и иногда какую-нибудь забывали.
Случай с коммитами
У нас это случилось на задаче про загрузку аватара. Промпт писали в спешке, между двумя созвонами, и последнюю строчку — «не коммить, я сам посмотрю» — не дописали.
Агент сделал всё хорошо. А потом, как аккуратный разработчик, закоммитил результат тремя коммитами. Один заодно поправил форматирование в соседнем файле. Вечер ушёл на то, чтобы всё разобрать и вернуть в рабочую копию.
Ему просто не сказали, что коммитить не нужно.
Написать один раз
Инклюд в Tascue — кусок текста, который пишется один раз на вкладке «Инклюды». В задаче вы отмечаете нужные, и при копировании они встают в конец промпта, каждый после разделителя ---.
Первым у нас стал «Без коммитов»: «Не делай коммиты и не пушь. Изменения оставь в рабочей копии». Мы сделали его общим, чтобы он был во всех проектах, и в меню «⋯» включили «Включать в новые задачи по умолчанию». Теперь он отмечен в каждой новой задаче. Если в какой-то задаче коммит нужен, галочку можно снять.
Как появляются инклюды
Список правил мы не составляли заранее. Инклюды появлялись по одному, после конкретных случаев.
«Короткий отчёт» — после того как агент пересказал каждый свой шаг на три экрана, и список изменённых файлов затерялся в середине. «Проверь в браузере» — после уверенного «готово» от агента, когда страница не открывалась из-за опечатки в шаблоне.
Мы сохраняем текст как инклюд, когда пишем его агенту второй раз. Так в списке остаётся только то, что действительно повторяется.
Ещё одна польза: при смене агента правила не нужно объяснять заново, они так же уходят в конце каждого промпта.
Два-три на задачу
Если в короткой задаче отметить восемь инклюдов, сама задача теряется среди них. Поэтому мы отмечаем два-три: «Без коммитов» по умолчанию и то, что нужно именно здесь. Редкие инклюды скрываем — в меню «⋯» есть «Показывать при выборе в задаче».
Если своих инклюдов пока нет, загляните в «Каталог» на вкладке «Инклюды»: там готовые тексты по группам — «Перед работой», «Код», «Проверка», «Git и деплой» и другие. Любой можно скопировать «В проект» или «В общие».
Скопированный текст можно поправить под свой проект.