Навыки агентов

Навык — директория с инструкциями в SKILL.md и дополнительными скриптами, справочными файлами и материалами. Портал хранит версии навыков и передаёт их агентам и рабочим пространствам.

Навык определяет, как выполнить задачу. Доступ к инструментам и объектам по-прежнему задаётся MCP-коллекциями и ролями пользователя.

Создание и публикация

Чтобы создать навык подготовки изменений проекта:

1. Откройте «AI» → «Навыки» → «Навыки» и нажмите «Создать навык».

2. Задайте название project-check, описание, владельца и команду.

3. Откройте черновик на вкладке «Файлы» и заполните SKILL.md:

   ---
   name: project-check
   description: Проверка изменений проекта перед передачей на рассмотрение. Используй после изменения файлов проекта.
   metadata:
     version: "1.0"
   ---
   
   # Проверка изменений
   
   1. Прочитай README.md и инструкции проекта.
   2. Определи тесты, относящиеся к изменённым файлам.
   3. Запусти эти тесты и проверь результат.
   4. Покажи список изменений, выполненные проверки и оставшиеся ограничения.

4. При необходимости добавьте файлы кнопкой «Добавить файл»: скрипты в scripts/, справочные материалы в references/, остальные материалы в assets/.

5. Сохраните черновик и проверьте панель ошибок и предупреждений.

6. Нажмите «Опубликовать версию», задайте уникальную метку, например v1, и опубликуйте.

Название и описание навыка определяются полями name и description в SKILL.md. Чтобы изменить их после создания, опубликуйте новую версию. Опубликованные файлы неизменяемы.

Импорт архива

Для импорта подготовьте tar.gz или zip с одной корневой директорией, название которой совпадает с name в SKILL.md:

project-check/
  SKILL.md
  references/
    checklist.md
  scripts/
    check.sh

В разделе навыков выберите «Загрузить из архива», загрузите файл и проверьте содержимое и версии навыка. Допустимые размеры приведены в ограничениях.

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

Чтобы агент получил опубликованный навык:

1. Откройте агент в «AI» → «Агенты» → «Каталог» и выберите редактирование.
2. На вкладке «Инструменты и навыки» добавьте навык и выберите конкретную версию либо «Последняя».
3. В «MCP-коллекции» подключите коллекцию с инструментом curated_get_skill; для чтения дополнительных файлов добавьте также curated_get_skill_file.
4. Предоставьте запускающему пользователю доступ к этим инструментам через доступные ему MCP-коллекции.
5. Сохраните агента и начните новый запуск.

При запуске агент получает названия и описания назначенных навыков и загружает полный текст при необходимости. Без доступного curated_get_skill набор навыков не передаётся; форма привязок показывает предупреждение. curated_list_skills предназначен для обычного MCP-клиента; агент получает свой подготовленный набор.

Если инструкция в SKILL.md прямо называет MCP-инструмент для платформенного агента, укажите его название с префиксом ddp_, например ddp_curated_get_skill_file или ddp_query_catalog. В каталоге коллекций те же инструменты называются curated_get_skill_file и query_catalog.

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

Подключение к рабочему пространству

Откройте шаблон рабочего пространства, вкладку «Навыки», и добавьте нужные навыки. Для каждой привязки выберите версию или «Последняя».

Набор фиксируется при создании и каждом запуске пространства. Новая версия навыка не заменяет набор в работающем пространстве немедленно; остановите и снова запустите его. На карточке пространства видны зафиксированные навыки и доступные обновления.

Для шаблона с Git настройте «Разрешить навыки из репозитория». При выключенном переключателе поле «Скрытые директории навыков» задаёт пути, исключаемые из рабочей копии. Например, .agents/skills или **/skills.

Скрытие использует Git sparse-checkout и не удаляет файлы из репозитория. Локальные изменения, неотслеживаемые файлы и конфликты могут остаться на диске; список таких файлов появляется предупреждением в логе запуска. Через git show содержимое репозитория остаётся доступным.

Установка в локальную IDE

Для использования навыка вне рабочего пространства DDP откройте его карточку, блок «Установка в IDE»:

1. Выберите «Последняя» или «Конкретная версия».
2. Создайте API-ключ портала в профиле и задайте его в переменной окружения DDP_API_KEY терминала.
3. Скопируйте команду из карточки и выполните её в корне локального проекта.
4. Проверьте появление .agents/skills/project-check/SKILL.md.

Команда скачивает архив выбранной версии и распаковывает его в .agents/skills. При повторном выполнении могут замениться файлы уже установленной копии навыка.

Устаревшие версии и архив

На вкладке «Версии» можно пометить версию устаревшей и указать причину. Такая версия не выбирается как «Последняя»; закреплённые привязки к ней сохраняются. Если активных версий не осталось, привязки «Последняя» пропускают навык.

Архивный навык пропускается при новых запусках с предупреждением. Вкладка «Использование» показывает доступные пользователю агенты и шаблоны, к которым он привязан. Перед архивированием проверьте этот список.

Ограничения

При подготовке навыка учитывайте ограничения:

Наличие скриптов, allowed-tools, длинного SKILL.md и отсутствие metadata.version могут давать предупреждения. Проверяйте их перед публикацией.