Самая полезная строчка в инструкции для ИИ-агента, которую я видел за последнее время: если база телеметрии отвечает «база не найдена» – подождать пять секунд и повторить запрос, потому что истек токен авторизации.

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

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

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

И еще один слой этой истории – роли. Когда часть работы отдают отдельному агенту, я бы описывал ее тремя вещами. Формулировка запроса там, на самом деле, далеко не главное:

Модель. Дешевая подойдет для сортировки и первичного просмотра, сильная – для разбора сложных причин.

Инструменты. Роли «собери статус» достаточно папки со статусами и трекера.

Запреты. Никогда не писать в общий репозиторий. Всегда группировать сбои по месту возникновения.

Менеджеру такие роли в буквальном виде, возможно, и не понадобятся. Но модель, инструменты и запреты переносятся на любое делегирование агенту. Роль без запретов работает как стажер без присмотра.

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

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

И черновик скилла собирает сам агент: берет повторяющийся промпт и список мест, где спотыкался. Как это устроено и что проверять в ответе