MessagesНавыки

Skills для предприятий

Copy page



Управление, проверка безопасности, оценка и организационные рекомендации по развёртыванию Agent Skills в масштабе предприятия.

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

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

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

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

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

Перед одобрением развёртывания оцените каждый Skill по следующим индикаторам риска:

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

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

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

Сканирование содержимого Skill

Организации Claude Enterprise могут включить автоматическое сканирование безопасности для пользовательских Skills в claude.ai и Claude Cowork. После включения параметра Skill and plugin security scanning в разделе claude.ai > Organization settings > Skills Skills, которые участники затем загружают или редактируют в claude.ai или Cowork, сканируются на признаки вредоносного поведения, такие как скрытое выполнение кода, отправка ваших данных во внешний сервис или инструкции, вмешивающиеся в защитные механизмы Claude. Skill, не прошедший сканирование или сканирование которого ещё не завершено, блокируется для использования. Skill, прошедший сканирование с предупреждением, остаётся доступным, но сопровождается предупреждающим уведомлением. Если сканирование доступно вашей организации, включите его. Оно дополняет, но не заменяет контрольный список проверки.

Сканирование не распространяется на Claude API. Skills, загружаемые через Skills API (/v1/skills), в том числе из Claude Console, не сканируются, поэтому при развёртывании через API полагайтесь на контрольный список проверки и закрепление версий. Сканирование также не применяется к Skills, которые уже были в вашей организации на момент его включения, а также к организациям с определёнными конфигурациями обработки данных, такими как управляемые клиентом ключи шифрования (CMEK), нулевое хранение данных (ZDR) или готовность к HIPAA. Шаги настройки, исключения и типы результатов см. в статье Get started with skill and plugin scanning в Справочном центре Claude.

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

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

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

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

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

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

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

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

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

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

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

1. 1

   Планирование

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

2. 2

   Создание и проверка

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

3. 3

   Тестирование

   Требуйте проведения оценок в изоляции (только Skill) и совместно с существующими Skills (тестирование сосуществования). Перед одобрением для производственной среды проверьте точность срабатывания, качество результата и отсутствие регрессий во всём вашем активном наборе Skills.

4. 4

   Развёртывание

   Загрузите через Skills API для доступа в масштабе всего рабочего пространства. Сведения о загрузке и управлении версиями см. в разделе Использование Skills с API. Задокументируйте Skill во внутреннем реестре с указанием назначения, владельца и версии.

5. 5

   Мониторинг

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

6. 6

   Итерация или вывод из эксплуатации

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

Организация Skills в масштабе

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Особенности работы на разных поверхностях

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

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