Docs
Пакет компании
Роли, сценарии и навыки одним файлом: перенос между организациями, хранение в git, резерв перед большой правкой.
This reference page is in Russian for now; the English version is on its way. The glossary maps the terms.
Роли, сценарии и навыки агента переносятся файлом: из одной организации в другую, в git на ревью, в резерв перед большой правкой. Формат файла — holycode.company-package/v1.
Из панелей — одним файлом
- Роли и сценарии. Раздел Персонал → карточка сценариев: «Скачать пакет компании» и «Загрузить пакет…».
- Навыки. Панель агента → Навыки: «Скачать пакетом» и «Загрузить пакет…».
Файл один и тот же: персонал берёт из него роли и сценарии, агент — навыки, остальное каждая сторона пропускает и говорит об этом.
Из консоли — папкой файлов
Утилита company-package раскладывает пакет в папку, удобную для git:
| Путь | Что там |
|---|---|
holycode-package.json | версия формата, когда выгружено, какие навыки включены |
roles/<role_id>@<версия>.json | роль: название, описание, документ роли |
pipelines/<pipeline_id>@<версия>.json | сценарий: исходник hpl/v1 |
skills/<имя>/SKILL.md | навык в обычном формате SKILL.md |
Повторная выгрузка в ту же папку заменяет роли, сценарии и навыки целиком — удалённое в организации исчезнет и из папки, и git покажет разницу. В чужую непустую папку без holycode-package.json утилита не пишет.
Что происходит при загрузке
- Выгружается текущая версия каждой роли и сценария (старшая выпущенная, а если выпущенной нет — старшая) и все версии ролей, на которые ссылаются выгруженные сценарии.
- Всё новое ложится черновиками, навыки — выключенными. Агенты продолжают получать то, что было выпущено.
- Номера версий у каждой организации свои. Сценарий ссылается на роль по номеру версии, поэтому при загрузке ссылки переписываются на номера, под которыми роли легли здесь. Поправили роль в файле — появится новая версия роли и новые версии сценариев, которые на неё ссылаются.
- Одинаковое не плодится. Роль, сценарий или навык с тем же содержимым — «уже есть»; повторная загрузка того же пакета ничего не меняет.
- Выпустить сразу (в панели — второй вопрос, в консоли —
--publish): выпускается только то, что выпущено в источнике, роли раньше сценариев. Сценарий, чья роль здесь не выпущена, остаётся черновиком — это не ошибка. Навыки включаются так же (--enable) — только включённые в источнике. - Навык с тем же именем из папки агента не перезаписывается: такие навыки правят в их папке.
Для выгрузки хватает ключа доступа read, для загрузки нужен read, write.