Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Это руководство предназначено для администраторов и архитекторов предприятий, которым необходимо управлять Agent Skills в рамках организации. Оно охватывает то, как проверять, оценивать, развертывать и управлять Skills в масштабе. Рекомендации по созданию см. в лучших практиках. Подробности архитектуры см. в обзоре Skills.
Развертывание Skills на предприятии требует ответа на два отдельных вопроса:
Оцените каждый Skill по этим индикаторам риска перед утверждением развертывания:
| Индикатор риска | На что обращать внимание | Уровень опасности |
|---|---|---|
| Выполнение кода | Скрипты в каталоге Skill (*.py, *.sh, *.js) | Высокий: скрипты выполняются с полным доступом к окружению |
| Манипуляция инструкциями | Директивы игнорировать правила безопасности, скрывать действия от пользователей или условно изменять поведение Claude | Высокий: может обходить средства контроля безопасности |
| Ссылки на серверы MCP | Инструкции, ссылающиеся на инструменты MCP (ServerName:tool_name) | Высокий: расширяет доступ за пределы самого Skill |
| Шаблоны сетевого доступа | URL-адреса, конечные точки API, вызовы fetch, curl или requests | Высокий: потенциальный вектор утечки данных |
| Жестко закодированные учетные данные | Ключи API, токены или пароли в файлах или скриптах Skill | Высокий: секреты раскрываются в истории Git и контекстном окне |
| Область доступа к файловой системе | Пути за пределами каталога Skill, широкие glob-шаблоны, обход путей (../) | Средний: может получить доступ к непредусмотренным данным |
| Вызовы инструментов | Инструкции, направляющие Claude использовать bash, файловые операции или другие инструменты | Средний: проверьте, какие операции выполняются |
Перед развертыванием любого Skill от третьей стороны или внутреннего участника выполните следующие шаги:
http, requests.get, urllib, curl, fetch).Skills могут ухудшить производительность агента, если они срабатывают неправильно, конфликтуют с другими Skills или предоставляют плохие инструкции. Требуйте оценку перед любым производственным развертыванием.
Установите контрольные точки утверждения по этим измерениям перед развертыванием любого Skill:
| Измерение | Что измеряет | Пример сбоя |
|---|---|---|
| Точность срабатывания | Активируется ли Skill для правильных запросов и остается ли неактивным для несвязанных? | Skill срабатывает при каждом упоминании электронной таблицы, даже когда пользователь просто хочет обсудить данные |
| Поведение в изоляции | Работает ли Skill корректно сам по себе? | Skill ссылается на файлы, которых нет в его каталоге |
| Сосуществование | Ухудшает ли добавление этого Skill другие Skills? | Описание нового Skill слишком широкое, перехватывает срабатывания у существующих Skills |
| Следование инструкциям | Точно ли Claude следует инструкциям Skill? | Claude пропускает шаги валидации или использует неправильные библиотеки |
| Качество вывода | Производит ли Skill правильные, полезные результаты? | Сгенерированные отчеты имеют ошибки форматирования или отсутствующие данные |
Требуйте от авторов Skill предоставления наборов оценок с 3–5 репрезентативными запросами на каждый Skill, охватывающими случаи, когда Skill должен срабатывать, не должен срабатывать, и неоднозначные граничные случаи. Требуйте тестирования на всех моделях, которые использует ваша организация (Haiku, Sonnet, Opus), поскольку эффективность Skill варьируется в зависимости от модели.
Подробные рекомендации по построению оценок см. в разделе оценка и итерация в лучших практиках. Общую методологию оценки см. в разделе разработка тестовых случаев.
Результаты оценки сигнализируют, когда нужно действовать:
Планирование
Определите рабочие процессы, которые являются повторяющимися, подверженными ошибкам или требующими специализированных знаний. Сопоставьте их с организационными ролями и определите, какие из них являются кандидатами для Skills.
Создание и проверка
Убедитесь, что автор Skill следует лучшим практикам. Требуйте проверку безопасности с использованием контрольного списка проверки. Требуйте набор оценок перед утверждением. Установите разделение обязанностей: авторы Skill не должны быть своими собственными проверяющими.
Тестирование
Требуйте оценки в изоляции (Skill отдельно) и вместе с существующими Skills (тестирование сосуществования). Проверьте точность срабатывания, качество вывода и отсутствие регрессий во всем вашем активном наборе Skills перед утверждением для производства.
Развертывание
Загрузите через Skills API для доступа на уровне рабочего пространства. См. Использование Skills с API для загрузки и управления версиями. Задокументируйте Skill в вашем внутреннем реестре с указанием цели, владельца и версии.
Мониторинг
Отслеживайте шаблоны использования и собирайте отзывы от пользователей. Периодически повторно запускайте оценки для обнаружения дрейфа или регрессий по мере развития рабочих процессов и моделей. Аналитика использования в настоящее время недоступна через Skills API. Реализуйте логирование на уровне приложения для отслеживания того, какие Skills включены в запросы.
Итерация или вывод из эксплуатации
Требуйте прохождения полного набора оценок перед продвижением новых версий. Обновляйте Skills, когда рабочие процессы меняются или показатели оценки снижаются. Выводите Skills из эксплуатации, когда оценки постоянно не проходят или рабочий процесс упразднен.
В качестве общего правила ограничивайте количество одновременно загружаемых Skills для поддержания надежной точности извлечения. Метаданные каждого Skill (имя и описание) конкурируют за внимание в системной подсказке. При слишком большом количестве активных Skills Claude может не выбрать правильный Skill или полностью пропустить релевантные. Используйте ваш набор оценок для измерения точности извлечения по мере добавления Skills и прекратите добавление, когда производительность ухудшается.
Обратите внимание, что запросы API поддерживают максимум 8 Skills на каждый запрос (см. Использование Skills с API). Если роль требует больше Skills, чем поддерживает один запрос, рассмотрите возможность объединения узких Skills в более широкие или маршрутизации запросов к разным наборам Skills в зависимости от типа задачи.
Поощряйте команды начинать с узких Skills, специфичных для рабочего процесса, а не с широких, многоцелевых. По мере появления закономерностей в вашей организации объединяйте связанные Skills в наборы на основе ролей.
Пример прогрессии:
formatting-sales-reports, querying-pipeline-data, updating-crm-recordssales-operations (когда оценки подтверждают эквивалентную производительность)Используйте согласованные соглашения об именовании во всей вашей организации. Раздел соглашения об именовании в лучших практиках предоставляет рекомендации по форматированию.
Ведите внутренний реестр для каждого Skill с указанием:
Группируйте Skills по организационным ролям, чтобы активный набор Skills каждого пользователя оставался сфокусированным:
Каждый набор на основе ролей должен содержать только те Skills, которые относятся к ежедневным рабочим процессам этой роли.
Храните каталоги Skill в Git для отслеживания истории, проверки кода через pull request'ы и возможности отката. Каждый каталог Skill (содержащий SKILL.md и любые прилагаемые файлы) естественным образом соответствует папке, отслеживаемой Git.
Skills API обеспечивает распространение в рамках рабочего пространства. Skills, загруженные через API, доступны всем участникам рабочего пространства. См. Использование Skills с API для конечных точек загрузки, версионирования и управления.
Храните исходные файлы Skill в Git как единственный источник истины. Если ваша организация развертывает Skills на нескольких поверхностях, реализуйте собственный процесс синхронизации для поддержания их согласованности. Полные подробности см. в разделе доступность на разных поверхностях.
Архитектура и детали платформы
Рекомендации по созданию для авторов Skill
Загружайте и управляйте Skills программно
Was this page helpful?