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

Другие расширения