Задача повторилась третий раз: пора делать инструкцию

Коротко

Как понять, что задача созрела для инструкции?

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

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

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

Чем задача подходит для оформления:

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

Инструкция против сохранённого промпта

Разница выглядит мелкой, а меняет всё.

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

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

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

Четыре блока внутри инструкции

Структура, к которой я пришёл опытным путём и от которой больше не отклоняюсь.

1. Когда это применять

   Описание ситуации словами, которыми её опишет человек. Не «обработка данных», а «мне прислали выгрузку из системы и нужен отчёт по неделе».

2. Порядок действий

   Шаги по одному, в том виде, в каком ты сам их делаешь. Здесь же места, где нужно остановиться и спросить тебя.

3. Красные линии

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

4. Критерий готовности

   Как выглядит правильный результат и как проверить, что получилось именно он. Без этого агент отчитается «сделано» на половине пути.

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

Про структуру самого запроса внутри шагов я писал отдельно в материале про канон промпта для агента: те же требования работают и внутри инструкции.

Почему инструкция не срабатывает?

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

Причина почти всегда в описании. Ты назвал инструкцию «Работа с отчётностью», а просишь «собери мне сводку по прошлой неделе». Для человека это одно и то же, для агента - нет.

Лечится переписыванием описания на язык запроса:

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

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

Что не стоит превращать в инструкцию?

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

Что я оставляю в ручном режиме:

• Решения, а не действия. «Выбрать подрядчика», «согласовать бюджет» - здесь порядок действий не главное, главное суждение.
• Работу с деньгами и внешними публикациями. Отправка, оплата, публикация наружу остаются с явным подтверждением. Инструкция может подвести к кнопке, но не нажать её.
• Задачи, которые пока меняются. Если процесс переделывается каждый месяц, инструкция устареет раньше, чем окупится.
• То, что делается раз в год. Через год ты всё равно перечитаешь её целиком и половину перепишешь.

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

Как это выглядит через полгода

Расскажу, к чему пришёл сам, потому что этот этап обычно не показывают.

Первые пять инструкций живут прекрасно. К десятой появляется вопрос «а есть ли у меня уже что-то на этот случай». К двадцатой - обнаруживаются две похожие, написанные с разницей в три месяца.

Что помогло:

• Реестр одной страницей. Название, одна строка «что делает», одна строка «когда звать». Читается за минуту, и в него смотрит не только человек, но и агент.
• Карточка на сложные. Если у инструкции есть зависимости или известные грабли, рядом лежит отдельный файл с ними. Остальным хватает строки в реестре.
• Правило записи ошибок. Каждый раз, когда что-то пошло не так, правка идёт в инструкцию, а не в голову. Иначе через месяц то же место повторится.

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

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

Частые вопросы

Главный вывод

Запомнить стоит одно: ты платишь не за работу агента, а за постановку задачи, и именно постановка повторяется. Инструкция снимает этот повтор.

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

А сколько раз за последний месяц ты объяснял одно и то же с нуля?