Пользовательские слэш-команды Claude Code
Skills — это механизм расширения Claude Code, посредством пользовательских слэш-команд (например,/deploy、/explain-code), чтобы расширить возможности Claude.
Каждая пользовательская команда по сути является независимым файлом Skill, который может инкапсулировать сложные рабочие процессы, соглашения проекта и часто используемые операции, позволяя быстро вызывать её в любой сессии.
Пользовательские команды были интегрированы в систему Skills — расположенные в.claude/commands/deploy.mdфайлах команд и расположенные в.claude/skills/deploy/SKILL.mdфайлах Skill, все будут создавать/deployкоманды, работающие таким же образом.
По сути,.claude/commands/— это сокращённая форма Skills, и эти две структуры каталогов полностью эквивалентны.
Почему стоит использовать пользовательские слэш-команды
Основная ценность пользовательских слэш-команд заключается встандартизации + повторном использовании:
- Кодифицируйте рабочие процессы: инкапсулируйте типовые многошаговые операции (например, «развернуть в продакшене») в одну команду
- Обеспечьте согласованность команды: кодифицируйте проектные соглашения (например, «чек-лист код-ревью») в команды, чтобы участники команды соблюдали одни и те же стандарты
- Снизьте когнитивную нагрузку: не нужно запоминать сложные комбинации команд; одной фразы достаточно, чтобы запустить весь рабочий процесс
- Сократите повторяющийся ввод: часто выполняемые задачи превращаются из многошаговых операций в один вызов
Опыт внутренней команды Anthropic таков: задачи, выполняемые более двух раз в день, следует превращать в Skills. Сделайте правильно один раз — и оно продолжит работать.
Структура файлов
Каждый Skill — это каталог, содержащий обязательныйSKILL.mdфайл:
my-skill/
├── SKILL.md # 主指令文件(必需)
├── template.md # Claude 填充的模板
├── examples/
│ └── sample.md # 展示预期格式的示例
└── scripts/
└── validate.sh # Claude 可以执行的脚本
Формат файла состоит из двух частей:
- YAML frontmatter(расположенный
---между разделителями): используется для настройки метаданных - тело Markdown: инструкции, которым Claude следует при вызове
Создайте свою первую пользовательскую слэш-команду
1. Создайте каталог навыка
Создайте каталог навыка в подходящем месте. Место хранения определяет область действия команды:
mkdir -p ~/.claude/skills/explain-code # 或者在项目中创建 mkdir -p .claude/skills/explain-code
2. Напишите файл SKILL.md
В каталоге создайтеSKILL.md, содержащий YAML frontmatter и инструкции:
Пример
name: explain-code
description: Объясняйте код с помощью визуальных диаграмм и аналогий. Когда объясняете, как работает код,
объясняете кодовую базу, или когда пользователь спрашивает"Как это работает?"используйте
---
При объяснении кода всегда включайте следующее:
1- **Начните с аналогии**: сравните код с повседневными вещами
2- **Нарисуйте диаграмму**: используйте ASCII-арт, чтобы показать поток, структуру или взаимосвязи
3- **Разберите код шаг за шагом**: объясните шаг за шагом, что происходит
4- **Укажите на подводный камень**: какие распространённые ошибки или заблуждения?
3. Используйте пользовательскую команду
Вызовите её напрямую в Claude Code:
/explain-code src/auth/login.ts
Claude автоматически подберёт навык, соответствующий описанию, или вы можете вызвать его явно.
Пояснение полей конфигурации
| Поле | Описание |
|---|---|
name |
Отображаемое имя; становится слэш-командой (формат: строчные буквы, цифры, дефисы, до 64 символов) |
description
|
Функция навыка и когда его использовать (рекомендуется заполнять; от этого поля зависит автоматический вызов Claude) |
argument-hint |
Подсказка, отображаемая при автодополнении (например,[filename] [format]) |
disable-model-invocation |
Установить вtrueесли задано, запрещает Claude автоматически вызывать; действует только когда вы явно его вызываете |
user-invocable |
Установить вfalseесли задано, из/скрыто из меню; только Claude может его вызвать |
allowed-tools |
Список инструментов, которые Claude может использовать без запроса |
context |
Установить вforkесли задано, запускается в субагенте ветки |
agent |
Setcontext: forkтип субагента, используемый, когда задано |
paths |
Список шаблонов Glob, ограничивающих область файлов для активации навыка |
Управление вызовом
Управляйте тем, кто может вызывать навык через frontmatter:
| Конфигурация | Вы можете вызывать | Claude может вызывать |
|---|---|---|
| (по умолчанию) | Да | Да |
disable-model-invocation: true |
Да | нет |
user-invocable: false |
нет | Да |
Подстановка переменных
Используйте переменные в содержимом навыка, и Claude автоматически заменит их:
| Переменная | Описание |
|---|---|
$ARGUMENTS |
Все аргументы, переданные при вызове |
$ARGUMENTS[N] |
Доступ к определённому параметру по индексу с отсчётом от 0 |
$N |
$ARGUMENTS[N]сокращение для |
${CLAUDE_SESSION_ID} |
ID текущего сеанса |
${CLAUDE_SKILL_DIR} |
Каталог, в котором находится файл SKILL.md навыка |
Места хранения навыков
Навыки можно хранить в нескольких местах с разными областями действия:
| Расположение | Путь | Область действия |
|---|---|---|
| Уровень предприятия | Определяется управляемыми настройками | Все пользователи в организации |
| Личный | ~/.claude/skills/<skill-name>/SKILL.md |
Все проекты |
| Проект | .claude/skills/<skill-name>/SKILL.md |
Только текущий проект |
| Плагин | <plugin>/skills/<skill-name>/SKILL.md |
В пределах включенной области действия плагина |
.claude/commands/Файлы внутри них по-прежнему действительны и поддерживают тот же frontmatter. Если навык и команда имеют одно и то же имя, приоритет имеет навык.
Расширенные примеры
Пример 1: Команда развертывания (только при ручном вызове)
Пример
name: deploy
description: Разверните приложение в производственной среде
disable-model-invocation: true
---
Разверните $ARGUMENTS в производственной среде:
1. Запустите набор тестов
2. Собрать приложение
3. Отправить в цель развёртывания
Пример 2: команда миграции компонента с аргументами
Пример
name: migrate-component
description: Мигрировать компонент из одного фреймворка в другой
---
Перенесите компонент $0 из $1 в $2.
Сохраните всё существующее поведение и тесты.
Использование: /migrate-component SearchBar React Vue
Пример 3: команда сводки PR с динамическим контекстом
Пример
name: pr-summary
description: Обобщить изменения в Pull Request
context: fork
agent: Explore
allowed-tools: Bash(gh *)
---
## Контекст пул-реквеста
- diff PR: !`gh pr diff`
- комментарии к PR: !`gh pr view --comments`
- Изменённые файлы: !`gh pr diff --name-only`
## Ваша задача
Составьте сводку по этому пул-реквесту...
Встроенные слэш-команды
Claude Code предоставляет несколько встроенных команд, которые работают из коробки:
| Команда | Функция |
|---|---|
/batch <instruction> |
Управляйте крупномасштабными изменениями по всей кодовой базе |
/claude-api |
Загрузите справочные материалы по API |
/debug [description] |
Включить отладочное логирование |
/loop [interval] <prompt> |
Запускать промпты повторно через интервалы |
/simplify [focus] |
Проверять проблемы качества кода |
Лучшие практики
1. Как писать description
description — основа автоматического вызова Claude, поэтому обязательно пишите его чётко:
- Уточните момент срабатывания:
Call when the user requests review / analysis / inspection of code quality - Укажите предусловия:
Use after the specification document has been confirmed - Пишите чёткие границы: случаи, в которых его не следует вызывать
2. Принцип единственной ответственности
Каждый навык должен делать только одну вещь, с чёткими входами/выходами:
/deploy: отвечает только за развёртывание/test: отвечает только за запуск тестов/review: отвечает только за проверку кода
3. Настройте разрешения на вызов при необходимости
- Опасные операции (развёртывание, удаление): Настройки
disable-model-invocation: true - Вспомогательные задачи Claude: Настройки
user-invocable: false - Общий рабочий процесс: используйте конфигурацию по умолчанию
4. Используйте allowed-tools для ограничения разрешений
Установите минимальные разрешения для операций, критичных с точки зрения безопасности:
Пример
name: read-only-analyzer
description: Анализ кода только для чтения, для проверки и понимания кода
allowed-tools: Read, Grep, Glob, Bash(gh *) # Разрешить только эти инструменты
---
Выполнить анализ кода только для чтения...
Стратегия командного обмена
Зафиксируйте навыки уровня проекта в git для совместного использования командой:
my-project/ ├── .claude/ │ ├── skills/ │ │ ├── deploy/ │ │ │ └── SKILL.md │ │ ├── test/ │ │ │ └── SKILL.md │ │ └── review/ │ │ └── SKILL.md │ └── commands/ # 也可以用 commands/ 目录 └── CLAUDE.md
Ссылайтесь на проектные навыки и объясняйте их в CLAUDE.md:
## 自定义斜杠命令 本项目提供以下自定义斜杠命令: - `/deploy [env]` — 部署到指定环境(dev/staging/prod) - `/test [module]` — 运行测试套件或指定模块 - `/review` — 执行标准代码审查 详细使用说明请参考 @.claude/skills/README.md
ЧАВО
Вопрос: В чём разница между навыками и каталогом commands?
По сути, разницы нет..claude/commands/Да.claude/skills/сокращённая форма, оба формата работают нормально. Если у них одинаковое имя, навыки имеют приоритет.
Вопрос: Как передать несколько параметров при вызове?
Используйте кавычки, чтобы заключить несколько параметров:/migrate SearchBar "from:React to:Vue", затем используйте его в навыке$ARGUMENTSчтобы получить полную строку.
Вопрос: Можно ли использовать навыки в субагентах?
Да. Установивcontext: forkиagentполе, субагенты могут запускать навыки в независимом контексте.
Вопрос: Как заставить Claude запоминать часто используемые навыки?
Перечислите все доступные пользовательские команды и сценарии их использования в CLAUDE.md, и Claude будет автоматически подбирать подходящий навык на основе описаний.
Другие расширения