Приватный реестр навыков

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

Когда использовать реестр

Используйте реестр навыков, когда хотите:

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

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

Видимость навыков

Каждый навык имеет параметр видимости, который определяет, кто может его видеть и установить:

Когда вы создаете навык, он начинается с параметра private.

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

Когда навык стабилен, вы можете опубликовать его, чтобы создать неизменяемый снимок, который можно проверить и установить:

1. Откройте навык в Навыки
2. Нажмите Опубликовать (или Опубликовать новую версию, если есть более старая версия)
3. Заполните список изменений — описать, что нового или что изменилось
4. Нажмите Опубликовать

Навык теперь находится в статусе pending_review. Администратор рабочего пространства или утверждающий может затем проверить и одобрить его.

Публикация создает версию:

• Версия 1 — первая опубликованная версия
• Версия 2 — следующий раз после внесения изменений
• Версия 3, 4 и т. д.

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

Рабочий процесс одобрения

Опубликованные навыки следуют рабочему процессу одобрения:

1. Автор публикует

Автор нажимает Опубликовать и навык переместится в pending_review.

2. Рецензент одобряет или отклоняет

Администратор рабочего пространства или рецензент может:

• Одобрить — навык переместится в approved и может быть установлен другими рабочими пространствами
• Отклонить — навык остается в черновике; автор может внести изменения и переотправить

Для проверки навыка:

1. Перейдите в Навыки → На проверке
2. Нажмите на навык
3. Проверьте код и список изменений
4. Нажмите Одобрить или Отклонить

3. Одобренные навыки можно установить

После одобрения другие рабочие пространства видят навык в Навыки → Реестр и могут его установить.

Установка навыка

Для установки навыка, опубликованного другим рабочим пространством:

1. Перейдите в Навыки → Реестр
2. Просмотрите одобренные навыки из других рабочих пространств
3. Нажмите Установить на навыке
4. Подтвердите установку

AACWorkflow создает локальную копию навыка в вашем рабочем пространстве, закрепленную на установленную версию. Ваша копия независима — редактирования исходного навыка не будут автоматически обновлять вашу копию.

Для обновления на более новую версию установленного навыка:

1. Перейдите в Навыки → Установленные
2. Найдите установленный навык
3. Нажмите Обновить

Последняя одобренная версия будет загружена в ваше рабочее пространство.

Для удаления навыка:

1. Перейдите в Навыки → Установленные
2. Найдите навык
3. Нажмите Удалить

Локальная копия удаляется, но агенты, которые ее используют, будут обновлены, чтобы показать, что навык недоступен.

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

Каждая опубликованная версия сохраняется, и вы можете просмотреть полную историю:

1. Откройте навык
2. Нажмите на вкладку Версии
3. Посмотрите все опубликованные версии с:
   • Номер версии
   • Автор и дата публикации
   • Список изменений
   • Diff от предыдущей версии

Чтобы увидеть, что изменилось между версиями:

1. На вкладке Версии выберите две версии
2. Нажмите Посмотреть различия

Удаленные строки показаны красным; добавленные строки — зеленым.

Метрики использования

Отслеживайте, как часто используется навык:

1. Откройте навык
2. Перейдите на вкладку Метрики

Вы увидите:

• Агенты, используя его — количество агентов, связанных с навыком
• Выполненные задачи — общее количество задач, которые работали с навыком
• Последнее использование — когда навык был выполнен последний раз

Используйте эти метрики для:

• Идентификации популярных навыков
• Поиска неиспользуемых навыков (рассмотрите их удаление)
• Понимания принятия навыков в масштабе вашей организации

Организация навыков

Стратегия видимости

• Private — экспериментальные или персональные навыки; не готовы к совместному использованию
• Workspace — навыки, которые использует каждый в вашем рабочем пространстве
• Organization — стабильные, проверенные инструменты, о которых должны знать другие команды

Соглашения об именовании

Используйте описательные имена, которые включают домен или инструмент:

• github-pr-reviewer — проверяет GitHub PR
• aws-cost-analyzer — анализирует расходы AWS
• sql-optimizer — оптимизирует SQL запросы
• internal-docs-generator — генерирует внутреннюю документацию

Организация

В рабочем пространстве используйте теги или префиксы для группировки связанных навыков:

• github-* — все навыки, связанные с GitHub
• aws-* — все навыки AWS
• internal-* — только внутренние инструменты

Лучшие практики

• Публикуйте только стабильные навыки — тщательно протестируйте перед публикацией
• Пишите четкие списки изменений — помогите рецензентам и пользователям понять, что изменилось
• Осторожно версионируйте — не переходите на другие версии; используйте семантическое версионирование (1.0 → 1.1 → 2.0)
• Сосредоточьте навыки — один навык, одна работа; разделите, если делает несколько вещей
• Архивируйте старые версии — после одобрения новой версии пользователям не должна быть нужна старая
• Документируйте зависимости — если навык требует внешних инструментов или API, документируйте это ясно

Управление версиями

Когда публикуется новая версия:

1. Старая версия остается одобренной — существующие установки продолжают работать
2. Новая версия входит на рассмотрение — должна быть одобрена
3. Пользователи могут обновиться — нажмите Обновить, чтобы получить последнюю одобренную версию
4. Закрепление — пользователи остаются на установленной версии, если они не обновляют вручную

Это означает:

• Ломающие изменения не принуждают к обновлению
• Пользователи выбирают, когда обновляться
• Старые версии остаются доступными для отката

Архивирование и отсутствие поддержки

Для выведения навыка:

1. Откройте навык
2. Перейдите в Настройки
3. Нажмите Архивировать

Архивированный навык:

• Перестает отображаться в реестре
• Не может быть вновь установлен
• Существующие установки все еще работают (но показывают уведомление об отсутствии поддержки)
• Агенты, которые уже его используют, могут продолжить работу, но пользователям советуется переключиться на замену

При необходимости установите рекомендуемую замену, чтобы пользователи знали, на что переключиться.

Обмен навыками между организациями

Если вы хотите обменяться навыком с людьми вне вашей организации:

1. Экспортируйте навык как файл (.tar.gz или аналогичный)
2. Обменяйтесь файлом внешним способом
3. Другие команды могут импортировать его через Навыки → Импортировать из файла

Публичный обмен (со всем сообществом AACWorkflow) в настоящее время не поддерживается, но этот приватный реестр позволяет легко делиться внутри вашей организации.

Безопасность и управление

• Ворота одобрения — все опубликованные навыки должны быть одобрены перед использованием
• Область рабочего пространства — навыки изолированы для каждого рабочего пространства; данные, специфичные для рабочего пространства, не утекают
• Версионирование — каждая версия неизменяема; изменения требуют новой версии и повторного одобрения
• Журнал аудита — все публикации, одобрения и установки регистрируются

Смотрите Подписание и проверка навыков для дополнительного управления и контрольных сумм.

Следующие шаги

• Подписание и проверка навыков — ворота одобрения и обнаружение изменений
• Навыки — узнайте, как создавать и использовать навыки
• Команды — организуйте агентов для использования конкретных навыков