Что вы узнаете
Расчетное время: 20 минут
К концу этого урока вы сможете:
- Делиться навыками с командой, добавляя их в репозиторий Git
- Распространять навыки между проектами через плагины и маркетплейсы
- Развертывать навыки по всей организации с помощью корпоративных управляемых настроек
- Настраивать пользовательские подагенты для использования конкретных навыков
Обмен навыками
(4 минуты)
Навыки становятся гораздо ценнее, когда их делятся внутри команды или организации. В этом видео рассматриваются три основных метода распространения — коммиты в репозиторий, плагины и корпоративные управляемые настройки — а также объясняется, как настраивать пользовательские подагенты для использования навыков. Вы узнаете, какой подход подходит для какой ситуации, и как справиться с важной особенностью: подагенты не наследуют навыки автоматически.
Основные выводы
- Навыки в `.claude/skills` автоматически распространяются через Git — любой, кто клонирует репозиторий, получает их
- Плагины позволяют распространять навыки между репозиториями через маркетплейсы для более широкого использования сообществом
- Корпоративные управляемые настройки развертывают навыки по всей организации с наивысшим приоритетом, идеально подходят для обязательных стандартов и соответствия требованиям
- Подагенты не видят ваши навыки автоматически — вы должны явно перечислить навыки в поле `skills` фронтендматера пользовательского агента
- Встроенные агенты (Explorer, Plan, Verify) не могут использовать навыки вообще — только пользовательские подагенты, определённые в `.claude/agents`
Навыки становятся гораздо ценнее, когда их делятся. Навык проверки запросов, который используете только вы, полезен, но тот же навык, распространённый по всей команде, стандартизирует ревью кода и создаёт единообразный опыт в организации. Давайте рассмотрим различные способы распространения навыков.
Добавление навыков в репозиторий
Самый простой способ обмена — это прямое добавление навыков в репозиторий. Разместите их в `.claude/skills`, и любой, кто клонирует репозиторий, получит эти навыки автоматически — не требуется дополнительная установка.
Когда вы отправляете обновления, все получают их при следующем `pull`. Этот подход хорошо подходит для:
- Стандартов кодирования в команде
- Проектных рабочих процессов
- Навыков, связанных со структурой вашей кодовой базы
Директория `.claude` содержит ваших агентов, хуков, навыков и настроек — все они контролируются версиями и делятся с командой через обычные Git-процессы.
Распространение навыков через плагины
Плагины — это способ расширения Claude Code с помощью пользовательского функционала, предназначенного для обмена между командами и проектами. В вашем проекте плагина создайте директорию `skills`, которая следует аналогичной структуре файлов, как и директория `.claude` — для каждого навыка создаётся отдельная папка с файлом `SKILL.md` внутри.
После того как вы распространите свой плагин через маркетплейс, другие пользователи смогут обнаружить его и установить в Claude Code.
Этот подход лучше всего подходит, когда ваши навыки не слишком специфичны для проекта и могут быть полезны участникам сообщества за пределами вашей команды.
Корпоративное развертывание через управляемые настройки
Администраторы могут развертывать навыки по всей организации через управляемые настройки. Корпоративные навыки имеют наивысший приоритет — они переопределяют личные, проектные и плагинные навыки с таким же именем.
Файл управляемых настроек поддерживает функции, такие как `strictKnownMarketplaces`, для контроля источников установки плагинов:
```json
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "npm",
"package": "@acme-corp/compliance-plugins"
}
]
```
Это подходящий выбор для обязательных стандартов, требований безопасности, рабочих процессов соответствия и практик кодирования, которые должны быть единообразными по всей организации. Ключевое слово здесь — «должны».
Навыки и подагенты
Вот что удивляет многих: подагенты не видят ваши навыки автоматически. Когда вы делегируете задачу подагенту, он начинает с чистого контекста.
Существуют важные различия, которые нужно понимать:
- Встроенные агенты (например, Explorer, Plan и Verify) не могут использовать навыки вообще
- Пользовательские подагенты, которые вы определяете, могут использовать навыки, но только если вы явно перечислите их
- Навыки загружаются при запуске подагента, а не по требованию, как в основном диалоге
Чтобы создать пользовательского подагента с навыками, добавьте файл агента в формате markdown в `.claude/agents`. Вы можете использовать команду `/agents` в Claude Code для интерактивного создания:
Сгенерированный файл агента включает поле `skills`, в котором перечислены навыки для загрузки. Вот как выглядит фронтендматер:
```markdown
name: frontend-security-accessibility-reviewer
description: "Use this agent when you need to review frontend code for accessibility..."
tools: Bash, Glob, Grep, Read, WebFetch, WebSearch, Skill...
model: sonnet
color: blue
skills: accessibility-audit, performance-check
```
Когда вы делегируете задачу этому подагенту, он загружает оба навыка и применяет их к каждому обзору. Сначала убедитесь, что навыки существуют в вашей директории `.claude/skills`, затем либо создайте нового подагента, либо добавьте поле `skills` в фронтендматер существующего агента.
Этот подход отлично работает, когда:
- Вам нужно изолированное делегирование задач с конкретной экспертизой
- Разным подагентам нужны разные навыки (например, фронтенд-ревьювер vs. бэкенд-ревьювер)
- Вы хотите обеспечить соблюдение стандартов в делегированной работе без использования промтов
Вопросы для размышления
- Какой метод обмена (репозиторий, плагин, корпоративный) больше всего подходит для навыков, которые вы планируете создать?
- Есть ли у вас рабочие процессы, в которых пользовательские подагенты с конкретными навыками могли бы улучшить согласованность в делегированной работе?
Что дальше
В последнем уроке вы узнаете, как устранять типичные проблемы с навыками — от неработающих триггеров до конфликтов приоритетов и ошибок времени выполнения — с помощью практического чек-листа, к которому можно обращаться в любой момент.
Обратная связь
По мере прохождения курса мы будем рады узнать, как вы используете навыки в своей работе, а также получить ваши отзывы. Поделитесь своими отзывами [здесь](https://example.com/feedback (внешняя ссылка отключена)).