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

Редактор

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

Рабочая копия

Выберите скилл — откроется его текст. Все правки попадают в черновик, не трогая опубликованную версию:

  • пометка «изменено» — черновик отличается от текущей версии; «как в текущей версии» — правок нет;
  • Показать изменения — подсветка того, что вы поменяли относительно текущей версии;
  • Сбросить правки — вернуть черновик к текущей версии, если эксперимент не удался.

Можно спокойно править и закрывать приложение — черновик никуда не денется, а установленные в AI копии не изменятся, пока вы не опубликуете и не обновите их.

Публикация версии

Когда черновик готов:

  1. Нажмите Опубликовать версию.
  2. Укажите номер в формате MAJOR.MINOR.PATCH (например, 1.2.0). Правило простое: третья цифра — мелкие правки, вторая — новые возможности, первая — большие переделки. onplate проверит формат и не даст создать дубликат существующей версии.
  3. Заполните «Что изменилось» — пару строк для истории. Через месяц вы скажете себе спасибо.

Публикация фиксирует версию в истории. Установленные копии при этом не обновляются сами — в Привязках у них появится пометка «есть новее», и вы решаете, когда обновлять.

История версий и откат

Блок История версий показывает все публикации: номер, дату и changelog. Текущая помечена. Кнопка Откатить возвращает любую прошлую версию — полезно, если новая редакция скилла работает хуже.

Сравнение версий

Блок Сравнение версий: выберите «С версии» и «До версии» — увидите, что именно изменилось между ними. Вместо версии можно выбрать черновик и сравнить его с любой публикацией. Если различий нет, так и будет написано: «Без изменений».

Метаданные скилла

Отдельная форма — свойства скилла:

  • Имя (slug) — уникальный идентификатор, из него складываются пути установки;
  • Заголовок и описание — то, что видит и человек, и AI при выборе скилла;
  • Автор;
  • Совместимость и целевые AI — с какими инструментами скилл работает;
  • Разрешения — список того, что скиллу позволено.

Кнопка Сохранить метаданные применяет изменения.