Навыки из GitLab

Источник навыков синхронизирует директории из GitLab с каталогом навыков DDP. Правки выполняются в GitLab; портал публикует неизменяемые версии.

Структура репозитория

Разместите навыки в непосредственных поддиректориях выбранного пути, каждый со своим SKILL.md:

skills/
  project-check/
    SKILL.md
    references/
      checklist.md
  release-prepare/
    SKILL.md
    scripts/
      check.sh

Название директории навыка должно совпадать с name его SKILL.md. Формат файла и ограничения описаны в руководстве по навыкам.

Подключение источника

Для синхронизации подготовьте подключение GitLab и реквизиты пользователя с доступом к проекту. Затем выполните шаги:

1. Откройте «AI» → «Навыки» → «Источники навыков» и нажмите «Создать источник».
2. Задайте название, идентификатор, владельца и команду источника.
3. На вкладке «Репозиторий» выберите «Внешний сервис GitLab» и «Пользователь для реквизитов».
4. Укажите «Проект» как group/project или числовой идентификатор, «Ветка или тег» и «Директория с навыками», например skills. Для корня репозитория используйте ..
5. На вкладке «Синхронизация» задайте «Расписание (cron)» и включите «Синхронизировать по расписанию», если нужна автоматическая синхронизация.
6. Сохраните источник и нажмите «Синхронизировать».
7. Проверьте «История синхронизаций» и созданные навыки.

Выключенный источник можно синхронизировать кнопкой. Команда источника управляет самим источником при включённом owner-is-admin; навыкам источника эта команда автоматически не передаётся.

Публикация изменений

При изменении содержимого директории синхронизация создаёт новую версию с меткой из первых 12 символов SHA коммита. Без изменения файлов новая версия не появляется.

Агенты и шаблоны с привязкой «Последняя» получают новую активную версию при следующем запуске. Закреплённые привязки продолжают использовать выбранную версию.

История синхронизаций показывает созданные, обновлённые, неизменившиеся, восстановленные, архивированные и пропущенные навыки. Для пропущенного навыка проверьте причину, формат SKILL.md, название директории, размеры файлов и реквизиты GitLab.

Удаление навыков из источника

Если директория исчезла из репозитория, навык архивируется. Возвращение директории восстанавливает навык, архивированный источником.

Для удаления источника его навыки должны быть в архиве. После удаления они остаются архивными ручными навыками со своими версиями.