Сценарии

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

Когда сценарий полезнее обычной просьбы:

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

Как попросить

Опишите в чате, кто что делает и что должно получиться:

Сделай сценарий: два ревьюера смотрят src/cart.js, у каждого своя задача (один — ошибки
в расчётах, другой — читаемость), третий сводит их замечания в короткий итог. Запусти его.

Агент пишет скрипт, проверяет его до запуска (типы результатов, фазы, команды) и запускает. Пока прогон идёт, в сессии видна строка фоновой работы, а агенты сценария спрашивают разрешения, как обычный субагент, — с пометкой «от субагента».

Когда прогон заканчивается, агент получает итог и рассказывает, что нашлось. Итог сценария (например, сводка ревью) сохраняется артефактом прогона.

Экран «Сценарии»

• Сохранённые — сценарии, которые можно запускать снова. У карточки — название, что делает, когда применять и аргументы. «Запустить» спрашивает значения аргументов, «Подробнее» — описание и аргументы для правки.
• Прогоны — все запуски: состояние, время, токены, затронутые файлы и строки, откуда запущен. «Ход прогона» открывает подробности:
  • фазы по порядку и агенты в каждой — с состоянием, временем и токенами;
  • артефакты — например, «Итог ревью» с пометкой «Главный итог» и версией;
  • «Открыть сессию» и «Исправить в чате» — вернуться к агенту, чтобы он поправил сценарий.

Сохранить и запускать снова

Если сценарий получился удачным, скажите «сохрани его». Агент сам не сохраняет — он предлагает и ждёт вашего согласия; сохранение вы подтверждаете.

Сохрани сценарий с аргументами: путь к файлу и два фокуса ревью.

• Аргументы — то, что меняется от запуска к запуску: путь к файлу, ветка, фокус ревью. У аргумента бывает значение по умолчанию и пометка «обязательный».
• Название — то, как сценарий называется на экране. Имя файла — латиницей, название — на вашем языке; поправить название и описание можно в «Подробнее».
• Сохранённые сценарии лежат у вас, а не в репозитории: ~/.config/buff/workflows/.

Запустить сохранённый сценарий можно с экрана «Сценарии» или попросив агента: «запусти ревью файла для src/checkout.js».

Что стоит знать

• Агенты сценария — субагенты: они видят проект, но не разговор основной сессии. Всё нужное им сценарий передаёт в задании.
• Прогон с ошибкой в скрипте не начинается: агент получает описание ошибки с номером строки и правит сценарий.
• Расход сценария идёт по тарифу организации, как у любого хода; в кабинете он виден в записях сессии.

В консоли

/workflows — сохранённые сценарии с запуском и прогоны с их состоянием и расходом. Просить агента сделать и сохранить сценарий можно так же, как в окне.