Навыки для предприятий

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

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

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

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 как единственный источник истины. Если ваша организация развёртывает навыки на нескольких поверхностях, реализуйте собственный процесс синхронизации для поддержания их согласованности. Полные сведения см. в разделе доступность на разных поверхностях.

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