Плагины и общие наборы: как раздать настройки ИИ-помощника команде

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

Бытовое сравнение: это чемодан инструментов. Мастер приходит на объект, открывает чемодан, и всё нужное уже лежит на своих местах. Внутри обычно те самые вещи, которые вы уже встречали в курсе: правила, кнопки быстрого вызова, помощники, подключения к сервисам.

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

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

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

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

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

Вы увидите: в папке проекта лежат файлы правил и команд, и их можно отправить вместе с проектом.

Можно хранить правила проекта, команды, навыки и описание подключений. Нельзя хранить ключи, токены, пароли и личные данные. Для секретов используйте файл окружения, исключённый из репозитория, и храните в проекте только пример без значений. Проверяйте это перед каждой отправкой проекта, особенно если репозиторий открытый.

# Скопируйте в .env и впишите свои значения. Сам .env в общий набор не попадает.
SERVICE_API_KEY=
SERVICE_URL=

Самая частая ошибка: файл .env создали, а в список исключений (.gitignore) не вписали, и ключ уехал вместе с проектом. Откройте .gitignore и найдите там строку .env. Если её нет, допишите.

Вы увидите: в проекте лежит .env.example с пустыми значениями, а настоящий .env внесён в список исключений.

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

Почему такая осторожность? Плагин работает с вашим компьютером почти так же, как вы сами. Если он просит доступ к файлам или хочет запускать команды, спросите себя, зачем ему это для заявленной задачи. Плагин для красивого оформления ответов не должен лезть в папку с ключами. Не получается ответить на вопрос «зачем» по описанию, значит, пока не ставьте. Новичку это кажется перестраховкой, но проверка занимает минут пять, а разбирать последствия можно неделю.

Короткая проверка перед установкой:

• понятно, кто автор и где лежит исходный текст;
• в описании сказано, что плагин делает и что ему нужно;
• в нём нет команд, которые удаляют файлы или отправляют данные неизвестно куда.

Вы увидите: у вас есть три вопроса, которые стоит задать любому плагину до установки.

Частично. Общий текстовый файл правил AGENTS.md читают многие инструменты, а форматы команд, навыков и плагинов у каждого свои и напрямую не переносятся. В таблице ниже видно, что переезжает как есть, а что придётся переписать под выбранную программу. Область молодая, так что это нормально.

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

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

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

1. Создайте в проекте папку team-kit и положите в неё копию AGENTS.md.
2. Добавьте файл .env.example с пустыми значениями, как в третьем шаге.
3. Создайте файл README.md с тремя строками: что в наборе, как подключить, к кому идти с вопросами.
4. Проверьте, что настоящий .env внесён в список исключений проекта.

# Набор для работы с ИИ-помощником

Что внутри: AGENTS.md с правилами, пример настроек .env.example.
Как подключить: скопируйте файлы в корень своего проекта и впишите свои ключи в .env.
Вопросы: напишите автору набора.

Не переписывайте README целиком: три строки лучше длинной инструкции, которую никто не дочитает. А настоящий .env в team-kit не копируйте даже «на минуточку».

Вы увидите: папка team-kit с тремя файлами (AGENTS.md, .env.example, README.md), и в ней нет ни одного настоящего ключа.

Передайте проект любым привычным способом: через общий репозиторий, архив или облачную папку. Коллега открывает проект и запускает помощника.

Проверка занимает одну минуту. Пусть коллега задаст помощнику вопрос:

Перечисли правила проекта из AGENTS.md своими словами и скажи, какие команды у нас есть.

Если помощник пересказал правила верно, набор доехал. Если нет, чаще всего коллега открыл не ту папку, и файл лежит уровнем выше или ниже.

Вы увидите: помощник коллеги пересказывает ваши правила, а ключи у каждого свои.