Claude Platform Docs
СообщенияНавыки

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

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

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

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

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

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

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

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

Индикатор рискаНа что обращать вниманиеУровень опасности
Выполнение кодаСкрипты в каталоге Skill (*.py, *.sh, *.js)Высокий: скрипты выполняются с полным доступом к окружению
Манипуляция инструкциямиДирективы игнорировать правила безопасности, скрывать действия от пользователей или условно изменять поведение ClaudeВысокий: может обходить средства контроля безопасности
Ссылки на серверы MCPИнструкции, ссылающиеся на инструменты MCP (ServerName:tool_name)Высокий: расширяет доступ за пределы самого Skill
Шаблоны сетевого доступаURL-адреса, конечные точки API, вызовы fetch, curl или requestsВысокий: потенциальный вектор утечки данных
Жёстко закодированные учётные данныеКлючи API, токены или пароли в файлах или скриптах SkillВысокий: секреты раскрываются в истории Git и в «context window» (контекстном окне)
Область доступа к файловой системеПути за пределами каталога Skill, широкие glob-шаблоны, обход путей (../)Средний: возможен доступ к непредусмотренным данным
Вызовы инструментовИнструкции, предписывающие Claude использовать bash, файловые операции или другие инструментыСредний: проверьте, какие операции выполняются

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

Перед развёртыванием любого 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. Этот параметр называется Проверка безопасности Skills и плагинов и находится в разделе claude.ai > Настройки организации > Skills.

После включения этого параметра сканирование применяется к Skills, которые участники впоследствии загружают или редактируют в claude.ai или Cowork. Каждое сканирование проверяет наличие признаков вредоносного поведения. К таким признакам относятся скрытое выполнение кода, передача ваших данных во внешний сервис и инструкции, вмешивающиеся в защитные механизмы Claude.

Возможность использования Skill зависит от результатов его сканирования:

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

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

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

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

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

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

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

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

ИзмерениеЧто измеряетсяПример сбоя
Точность срабатыванияАктивируется ли Skill для правильных запросов и остаётся ли неактивным для не относящихся к нему?Skill срабатывает при каждом упоминании электронной таблицы, даже когда пользователь просто хочет обсудить данные
Поведение в изоляцииКорректно ли работает Skill сам по себе?Skill ссылается на файлы, которых нет в его каталоге
СосуществованиеУхудшает ли добавление этого Skill работу других Skills?Описание нового Skill слишком широкое и перехватывает срабатывания у существующих Skills
Следование инструкциямТочно ли Claude следует инструкциям Skill?Claude пропускает шаги валидации или использует неправильные библиотеки
Качество результатаВыдаёт ли Skill корректные и полезные результаты?Сгенерированные отчёты содержат ошибки форматирования или пропущенные данные

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  5. Мониторинг

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

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

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

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

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

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

Обратите внимание, что запросы к API поддерживают максимум 20 Skills на каждый запрос (см. Использование Agent 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, которые относятся к повседневным рабочим процессам данной роли.

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

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

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

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

Skills API обеспечивает распространение в пределах рабочего пространства. Skills, загруженные через API, доступны всем участникам рабочего пространства. На Claude Models on Google Cloud (Anthropic managed) совместный доступ работает иначе. Подробности см. в разделе Область общего доступа обзора Agent Skills. Сведения о конечных точках для загрузки, управления версиями и администрирования см. в разделе Использование Agent Skills с API.

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

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

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

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

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

Архитектура и сведения о платформе

Рекомендации по созданию для авторов Skill

Программная загрузка и управление Skills

Эта страница была полезной?