Примерное время: 20 минут
К концу этого урока вы сможете:
- Делиться навыками (skills) со своей командой, фиксируя их в репозитории Git
- Распространять навыки (skills) между проектами с помощью плагинов (plugins) и маркетплейсов (marketplaces)
- Развертывать навыки (skills) в масштабах всей организации, используя управляемые корпоративные настройки
- Настраивать пользовательские субагенты (subagents) для использования конкретных навыков (skills)
Обмен навыками (skills)
(4 минуты)
Навыки (skills) становятся гораздо более ценными, когда ими делятся в команде или организации. Это видео охватывает три основных метода распространения — фиксацию в репозитории, плагины (plugins) и управляемые корпоративные настройки — и объясняет, как настроить пользовательские субагенты (subagents) для использования навыков (skills). Вы узнаете, какой подход подходит для какого сценария и как справиться с важной особенностью: субагенты (subagents) не наследуют навыки (skills) автоматически.
Ключевые выводы
- Навыки (skills) проекта в
.claude/skillsавтоматически распространяются через Git — любой, кто клонирует репозиторий, получает их - Плагины (Plugins) позволяют распространять навыки (skills) между репозиториями через маркетплейсы (marketplaces) для более широкого использования сообществом
- Управляемые корпоративные настройки (Enterprise managed settings) развертывают навыки (skills) в масштабах всей организации с наивысшим приоритетом, что идеально подходит для обязательных стандартов и соответствия требованиям
- Субагенты (Subagents) не видят ваши навыки (skills) автоматически — вы должны явно перечислить навыки (skills) в поле
skillsв frontmatter пользовательского агента (agent) - Встроенные агенты (agents) (Explorer, Plan, Verify) вообще не могут получить доступ к навыкам (skills) — это могут делать только пользовательские субагенты (subagents), определенные в
.claude/agents
Навыки (skills) становятся гораздо более ценными, когда ими делятся. Навык (skill) проверки PR, который используете только вы, полезен, но тот же навык (skill), распространенный по всей вашей команде, стандартизирует проверку кода и создает единообразный опыт во всей вашей организации. Давайте рассмотрим различные способы распространения навыков (skills).
Фиксация навыков (skills) в вашем репозитории
Самый простой метод обмена — это фиксация навыков (skills) непосредственно в вашем репозитории. Разместите их в .claude/skills, и любой, кто клонирует репозиторий, автоматически получит эти навыки (skills) — дополнительная установка не требуется.
Когда вы отправляете обновления, все получают их при следующем pull. Этот подход хорошо работает для:
- Стандартов кодирования команды
- Рабочих процессов, специфичных для проекта
- Навыков (skills), которые ссылаются на структуру вашей кодовой базы
Каталог .claude содержит ваших агентов (agents), хуки (hooks), навыки (skills) и настройки — все это контролируется версиями и распространяется в команде через обычные рабочие процессы Git.
Распространение навыков (skills) через плагины (plugins)
Плагины (Plugins) — это способ расширить Claude Code пользовательской функциональностью, предназначенной для обмена между командами и проектами. В вашем проекте плагина (plugin) создайте каталог skills, который следует аналогичной файловой структуре каталога .claude — каждый навык (skill) получает свою собственную папку с файлом SKILL.md внутри.
После того как вы распространите свой плагин (plugin) на маркетплейсе (marketplace), другие пользователи смогут найти и установить его в Claude Code для себя.
Этот подход лучше всего подходит, когда ваши навыки (skills) не слишком специфичны для проекта и могут быть полезны членам сообщества за пределами вашей непосредственной команды.
Корпоративное развертывание через управляемые настройки
Администраторы могут развертывать навыки (skills) в масштабах всей организации через управляемые настройки. Корпоративные навыки (skills) имеют наивысший приоритет — они переопределяют личные навыки (skills), навыки (skills) проекта и навыки (skills) плагинов (plugins) с тем же именем.
Файл управляемых настроек поддерживает такие функции, как strictKnownMarketplaces, для контроля того, откуда могут быть установлены плагины (plugins):
"strictKnownMarketplaces": [
{
"source": "github",
"repo": "acme-corp/approved-plugins"
},
{
"source": "npm",
"package": "@acme-corp/compliance-plugins"
}
]Это правильный выбор для обязательных стандартов, требований безопасности, рабочих процессов соответствия и практик кодирования, которые должны быть последовательными во всей организации. Ключевое слово здесь — "должны".
Навыки (skills) и субагенты (subagents)
Вот что удивляет людей: субагенты (subagents) не видят ваши навыки (skills) автоматически. Когда вы делегируете задачу субагенту (subagent), он начинает с нового, чистого контекста.
Важно понимать следующие различия:
- Встроенные агенты (agents) (такие как Explorer, Plan и Verify) вообще не могут получить доступ к навыкам (skills)
- Пользовательские субагенты (subagents), которые вы определяете, могут использовать навыки (skills), но только если вы явно их перечислите
- Навыки (skills) загружаются при запуске субагента (subagent), а не по требованию, как в основном разговоре
Чтобы создать пользовательский субагент (subagent) с навыками (skills), добавьте файл markdown агента (agent) в .claude/agents. Вы можете использовать команду /agents в Claude Code для интерактивного создания:
Сгенерированный файл агента (agent) включает поле skills, которое перечисляет, какие навыки (skills) загружать. Вот как выглядит frontmatter:
---
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
---Когда вы делегируете задачу этому субагенту (subagent), у него загружены оба навыка (skills), и он применяет их к каждой проверке. Сначала убедитесь, что навыки (skills) существуют в вашем каталоге .claude/skills, затем либо создайте нового субагента (subagent), либо добавьте поле skills в файл markdown существующего агента (agent).
Этот шаблон очень хорошо работает, когда:
- Вы хотите изолированное делегирование задач с конкретной экспертизой
- Различным субагентам (subagents) нужны разные навыки (skills) (например, рецензент frontend против рецензента backend)
- Вы хотите обеспечить соблюдение стандартов в делегированной работе, не полагаясь на подсказки (prompts)
Размышления об уроке
- Какой метод обмена (репозиторий, плагин (plugin), корпоративный) наиболее подходит для навыков (skills), которые вы планировали создать?
- Есть ли у вас рабочие процессы, где пользовательские субагенты (subagents) с конкретными навыками (skills) улучшили бы согласованность в делегированной работе?
Что дальше
В последнем уроке вы узнаете, как устранять распространенные проблемы с навыками (skills) — от навыков (skills), которые не срабатывают, до конфликтов приоритетов и ошибок выполнения — с помощью практического контрольного списка, к которому вы можете обращаться в любое время.
Обратная связь
По мере прохождения курса мы будем рады узнать, как вы используете навыки (skills) в своей работе, а также любые ваши отзывы. Поделитесь своим мнением здесь.