Расширения: MCP, навыки, хуки и другое

Всё, чем можно дополнить агента, собрано в «Настройки → Расширения» — у вас лично (для всех проектов) и в настройках проекта (для этого репозитория). Файлы конфигурации руками править не нужно: формы пишут их сами и не трогают остальное содержимое файла.

Вкладки: MCP, Плагины, Навыки, Команды, Субагенты, Хуки, Память.

Где хранится: у меня или в проекте

У каждой записи — область:

• у меня — в каталоге конфигурации пользователя, действует во всех проектах, в репозиторий не попадает;
• в проекте — в файлах проекта (buffcode.json, .buffcode/; если в проекте уже есть прежние opencode.json и .opencode/, запись идёт в них), уезжает в репозиторий вместе с кодом и действует у всех, кто его откроет. Форма предупреждает об этом.

MCP-серверы

• Серверы Buff Code — buff (интеграции компании и MCP-серверы администратора через коннектор), knowledge (база знаний организации), repos (репозитории проекта, только чтение). Они подключаются сами после входа; их можно выключить, но не изменить. Подробно — Инструменты подключений, База знаний, Репозитории проекта.
• Свои серверы — «Добавить сервер»: локальный (команда) или удалённый (адрес). Форма — вкладки «Поля» и «JSON»; во вкладку JSON можно вставить запись из настроек другого агента, в том числе целый блок mcpServers.
• У сервера — статус словами: «Подключён», «Подключается…», «Выключен», «Нужен вход», «Не запустился — причина» («Команда не найдена…», «Сервер по этому адресу не отвечает…»). Выключатель записывается в файл и переживает перезапуск.

• Подстановки вида {env:TOKEN} сохраняются как написаны — секрет из окружения в файл не попадёт.

Навыки

Навык — файл SKILL.md с инструкцией для типовой работы: «как готовить заметки к выпуску», «как проверять миграции». Агент сам решает, когда навык нужен, или вы называете его в сообщении (@навык).

• Список с поиском по названию и описанию, группы по происхождению: проект, мои, подключённые. У каждого — описание и выключатель.
• «Создать навык» — название, описание, текст. «Подключить каталог» — папка или адрес с готовыми навыками команды.
• Выключенный навык остаётся на диске, но агент его не видит и в подсказках @ его нет.

Команды и субагенты

• Команда — заготовленный запрос под своим именем: /release-notes, /git/sync. Задаются описание, текст, агент, модель и где выполнять — в текущей сессии или отдельным субагентом.
• Субагент — агент для поручений: «когда вызывать», режим, модель, инструкция. Основной агент передаёт ему работу и получает итог.
• Встроенные команды и агенты видны в тех же списках, их можно выключить, но не править. Последнего основного агента выключить нельзя.

Память

Память — файлы AGENTS.md: общий у вас и файлы проекта — от корня репозитория до открытой папки. Агент читает их в начале каждой сессии.

• Текст правится на месте; видно, когда файл изменён.
• У каждого файла — выключатель, и есть общий выключатель памяти.

Хуки

Хук — команда оболочки, которая выполняется на событие:

Событие приходит команде в JSON — на вход и в переменной BUFF_HOOK_EVENT.

Доверие к хукам и командам проекта

Хуки и команды проекта приходят вместе с репозиторием — их писали не вы. Поэтому они не выполняются, пока вы не посмотрели их текст и не подтвердили.

• Над полем ввода появляется полоса о хуках и командах проекта, которые ждут проверки; в настройках у таких записей — пометка и «Проверить».
• Подтверждение привязано к содержимому: запись изменилась — Buff Code спросит снова.
• Выключатель «Проверять хуки и команды проекта» — во вкладке «Хуки» и в третьем шаге знакомства. Выключайте его только для своих проектов.

В консоли