Вся документация

Команда

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

Какой способ выбрать

СпособКто на другом концеКаналКогда
Профиль командывся компанияGit-репозиторий с реестрому всех должен быть одинаковый набор, у разных ролей — свой
Профиль проектате, кто работает над конкретным кодомфайл в самом репозитории кода«этому проекту нужны вот эти скиллы»
Набор файломконкретный коллегафайл в мессенджере или почтебыстро отдать выбранное, без репозиториев и договорённостей

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


Способ 1. Профиль команды

Решает задачу «у всех в команде должен быть одинаковый набор». Один человек публикует эталон в общий Git-репозиторий, остальные подключают его — и onplate у каждого следит, чтобы набор был установлен и актуален.

Подключить профиль

  1. В поле Реестр команды выберите Git-источник с реестром. Если источников нет — сначала подключите репозиторий команды в разделе Репозитории или импортируйте его как пакет.
  2. Выберите роли — например, «аналитик» или «поддержка»: профиль может задавать разные наборы для разных ролей. Роль наследует базовый набор, а добавляет только своё.
  3. Выберите режим синхронизации:
    • Выключено — профиль подключён, но ничего не проверяется;
    • Только уведомлять — onplate показывает расхождения, решение за вами;
    • Автоматически доустанавливать — недостающее ставится само.

Расхождения с профилем

Таблица показывает, чем ваша машина отличается от эталона:

СтатусЧто значит
Не установленПакет есть в профиле, у вас его нет
УстарелУстановлена старая версия
АктуаленВсё совпадает
Вне профиляПакет установлен у вас, но в профиле не значится
Нет в реестреПрофиль ссылается на пакет, которого в реестре нет

Кнопка Обновить пересчитывает отчёт, Применить — устанавливает и обновляет выбранное с подтверждением. По каждому пакету виден итог: установлен, обновлён, пропущен, нужно вручную или ошибка.

Расхождение считается и по AI-инструментам: пакет нужной версии, но стоящий не на всех целевых AI, честно показывается недостающим — а не «актуальным».

Опубликовать набор для команды

Обратная операция — вы собираете эталон:

  1. Нажмите Опубликовать набор для команды.
  2. Укажите название набора и, при необходимости, роль.
  3. Выберите формат:
    • Папка (репозиторий) — onplate соберёт реестр в папку, а закоммитите вы сами;
    • Zip-бандл — один файл, удобно переслать;
    • Прямо в Git — onplate сам закоммитит и запушит: укажите URL репозитория, ветку, токен с правом записи и сообщение коммита.
  4. Опасные пакеты в набор по умолчанию не попадают — их включает отдельный флажок «Включая опасные».

Если с прошлой публикации ничего не менялось, onplate так и скажет: «Изменений нет — реестр уже актуален».


Способ 2. Профиль проекта

Файл .onplate/profile.json в репозитории кода, который говорит «этому коду нужны вот эти скиллы, MCP-серверы и субагенты». Его пишет onplate, а читают люди в диффе pull request — и это, а не установка, главная его ценность: договорённость обсуждается там же, где обсуждается всё остальное в проекте.

Подробно — в разделе Профиль проекта.

Кнопка Поделиться с командой здесь же, в блоке «Как поделиться».


Способ 3. Набор файлом

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

Набор — обычный пакет onplate. Получатель может открыть его выборочно («Открыть набор») или импортировать целиком, как любой другой пакет.

Собрать набор

Нажмите Собрать набор в блоке «Как поделиться».

  1. Название набора и кто собрал — второе увидит получатель. Это единственное место, где будет написано, откуда файл взялся: по мессенджеру приезжает просто архив.
  2. Отметьте, чем делитесь. В списке — скиллы, MCP-серверы и субагенты из вашего хранилища. У каждой строки версия, оценка безопасности и вес в токенах.
  3. Внизу — сумма: «набор добавит N токенов в контекст». Это цена, которую получатель заплатит при каждом запросе к AI, а не украшение.
  4. Показать манифест — сам файл, который запишется. Открывайте хотя бы раз: доверие даётся показом, а не обещанием.
  5. Формат: один файл .zip (по умолчанию — набор передают человеку) или папка.
  6. Сохранить набор — выберите, куда положить.

Что в набор не попадёт

  • Значения секретов. Ни помеченные секретами, ни токен, который вы вписали в обычную переменную окружения: onplate узнаёт учётные данные по формату (ghp_…, AKIA…, блок приватного ключа) и заменяет их требуемым секретом. Получатель введёт свои. О каждой подмене вам скажут до записи файла.
  • Опасное без обоснования. Скилл с оценкой «Опасно» уедет только с вашим объяснением зачем — и объяснение поедет вместе с ним.

Отдельно предупредим, если в теле скилла остался путь вашей машины (/Users/вы/…): у коллеги его не будет. Это предупреждение, а не запрет.

Открыть набор

Нажмите Открыть набор и выберите присланный файл или папку. .zip распаковывать самому не нужно.

Сначала — предпросмотр, и ничего в хранилище не попадает, пока вы не выберете. Видно, кто собрал набор и когда, а по каждой записи — что она значит лично для вас:

ПометкаЧто значитОтмечено заранее
нового у вас неттакой записи в хранилище нетда
уже есть такое жесодержимое совпадает с вашимнет
есть другое с таким именемимя занято, содержимое отличаетсянет

Сравнение идёт по содержимому, а не по номеру версии: чужая «1.0.0» ничего не говорит о том, совпадают ли байты.

Заранее отмечено только новое. То, что у вас уже есть, и опасные записи вы включаете сами — галочка не должна решать за вас.

Если имя занято

Ваша запись не затирается никогда. onplate предложит взять чужую под новым именем — например, go-review-from-alice — и обе останутся у вас. Имя можно изменить прямо в диалоге.

Импорт не устанавливает

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

Что видно потом

Запись, приехавшая из набора, помечена в карточке: Источник: project-profile или имя набора и автор. Через месяц вопрос «откуда это у меня взялось» задают не тому, кто принёс, — и ответ должен лежать в самой записи.