Навыки для корпоративного использования

Это руководство предназначено для корпоративных администраторов и архитекторов, которым необходимо управлять Agent Skills в масштабах организации. В нём рассматривается, как проверять, оценивать, развёртывать навыки и управлять ими в масштабе. Рекомендации по созданию навыков см. в разделе лучшие практики. Подробности об архитектуре см. в обзоре навыков.



Проверка безопасности и аудит

Развёртывание навыков на предприятии требует ответа на два отдельных вопроса:

1. Безопасны ли навыки в целом? См. раздел соображения безопасности в обзоре для получения сведений о безопасности на уровне платформы.
2. Как проверить конкретный навык? Используйте приведённые ниже оценку рисков и контрольный список проверки.



Оценка уровня риска

Оцените каждый навык по следующим индикаторам риска, прежде чем одобрить его развёртывание:



Контрольный список проверки

Перед развёртыванием любого навыка от третьей стороны или внутреннего автора выполните следующие шаги:

1. Прочитайте всё содержимое каталога навыка. Просмотрите SKILL.md, все упомянутые markdown-файлы и любые включённые скрипты или ресурсы.
2. Убедитесь, что поведение скриптов соответствует заявленной цели. Запустите скрипты в изолированной среде и убедитесь, что результаты соответствуют описанию навыка.
3. Проверьте наличие враждебных инструкций. Ищите директивы, которые предписывают Claude игнорировать правила безопасности, скрывать действия от пользователей, передавать данные через ответы или изменять поведение в зависимости от определённых входных данных.
4. Проверьте наличие обращений к внешним URL или сетевых вызовов. Ищите в скриптах и инструкциях паттерны сетевого доступа (http, requests.get, urllib, curl, fetch).
5. Убедитесь в отсутствии жёстко закодированных учётных данных. Проверьте наличие ключей API, токенов или паролей в файлах навыка. Учётные данные должны использовать переменные окружения или защищённые хранилища учётных данных и никогда не появляться в содержимом навыка.
6. Определите инструменты и команды, которые навык предписывает Claude вызывать. Перечислите все команды bash, файловые операции и ссылки на инструменты. Учитывайте совокупный риск, когда навык использует одновременно инструменты чтения файлов и сетевые инструменты.
7. Подтвердите назначения перенаправлений. Если навык ссылается на внешние URL-адреса, убедитесь, что они указывают на ожидаемые домены.
8. Убедитесь в отсутствии паттернов утечки данных. Ищите инструкции, которые считывают конфиденциальные данные, а затем записывают, отправляют или кодируют их для внешней передачи, в том числе через разговорные ответы Claude.



Оценка навыков перед развёртыванием

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



Что оценивать

Установите контрольные точки одобрения по следующим параметрам перед развёртыванием любого навыка:



Требования к оценке

Требуйте от авторов навыков предоставлять наборы оценок с 3–5 репрезентативными запросами на каждый навык, охватывающими случаи, когда навык должен срабатывать, не должен срабатывать, а также неоднозначные пограничные случаи. Требуйте тестирования на всех моделях, которые использует ваша организация (Haiku, Sonnet, Opus), поскольку эффективность навыков варьируется в зависимости от модели.

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



Использование оценок для принятия решений о жизненном цикле

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

• Снижение точности срабатывания: обновите описание или инструкции навыка
• Конфликты совместимости: объедините пересекающиеся навыки или сузьте описания
• Стабильно низкое качество вывода: перепишите инструкции или добавьте шаги валидации
• Постоянные сбои после обновлений: выведите навык из эксплуатации



Управление жизненным циклом навыков



Организация навыков в масштабе



Ограничения на полноту выбора

В качестве общей рекомендации ограничивайте количество одновременно загружаемых навыков, чтобы поддерживать надёжную точность выбора. Метаданные каждого навыка (название и описание) конкурируют за внимание в системной подсказке. При слишком большом количестве активных навыков Claude может не выбрать правильный навык или полностью пропустить релевантные. Используйте свой набор оценок для измерения точности выбора по мере добавления навыков и прекращайте добавление, когда производительность снижается.

Обратите внимание, что запросы к API поддерживают максимум 8 навыков на запрос (см. Использование навыков с API). Если роль требует больше навыков, чем поддерживает один запрос, рассмотрите возможность объединения узких навыков в более широкие или маршрутизации запросов к разным наборам навыков в зависимости от типа задачи.



Начинайте с конкретного, объединяйте позже

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

Пример развития:

• Начало: formatting-sales-reports, querying-pipeline-data, updating-crm-records
• Объединение: sales-operations (когда оценки подтверждают эквивалентную производительность)



Именование и каталогизация

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

Ведите внутренний реестр для каждого навыка со следующими данными:

• Назначение: какой рабочий процесс поддерживает навык
• Владелец: команда или лицо, ответственное за сопровождение
• Версия: текущая развёрнутая версия
• Зависимости: требуемые MCP-серверы, пакеты или внешние сервисы
• Статус оценки: дата последней оценки и результаты



Ролевые наборы

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

• Отдел продаж: операции с CRM, отчётность по воронке продаж, генерация предложений
• Инженерия: проверка кода, рабочие процессы развёртывания, реагирование на инциденты
• Финансы: генерация отчётов, валидация данных, подготовка к аудиту

Каждый ролевой набор должен содержать только навыки, релевантные для повседневных рабочих процессов этой роли.



Распространение и контроль версий



Система контроля версий

Храните каталоги навыков в Git для отслеживания истории, проверки кода через pull-запросы и возможности отката. Каждый каталог навыка (содержащий SKILL.md и любые включённые файлы) естественным образом соответствует папке, отслеживаемой в Git.



Распространение через API

Skills API обеспечивает распространение в рамках рабочего пространства. Навыки, загруженные через API, доступны всем участникам рабочего пространства. См. Использование навыков с API для получения информации о конечных точках загрузки, версионирования и управления.



Стратегия версионирования

• Производственная среда: закрепляйте навыки за конкретными версиями. Запускайте полный набор оценок перед продвижением новой версии. Рассматривайте каждое обновление как новое развёртывание, требующее полной проверки безопасности.
• Разработка и тестирование: используйте последние версии для валидации изменений перед продвижением в производственную среду.
• План отката: сохраняйте предыдущую версию в качестве резервной. Если новая версия не проходит оценки в производственной среде, немедленно вернитесь к последней заведомо рабочей версии.
• Проверка целостности: вычисляйте контрольные суммы проверенных навыков и проверяйте их во время развёртывания. Используйте подписанные коммиты в репозитории навыков для обеспечения подлинности происхождения.



Особенности работы на разных платформах

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



Дальнейшие шаги