Команда — переиспользуемый промпт, сохранённый markdown-файлом, который вы вызываете по имени: набираете `/` в чате и выбираете команду из списка. В отличие от [навыка](/docs/skills), который агент подгружает сам, когда его описание подходит задаче, команда работает только по явному вызову — это готовый шаблон запроса, а не процедура, которую агент ищет самостоятельно.

Не путайте со встроенными командами чата вроде `/clear` или `/models` — тот список зашит в клиент и описан в [справочнике слэш-команд](/docs/reference/slash-commands). На этой странице — про ваши собственные команды, которые вы заводите файлами в проекте или в профиле.

## Формат файла команды

```markdown
---
description: Что делает команда и когда её использовать.
argument-hint: "[issue-number]"
---

Тело файла — промпт, который агент увидит, когда вы вызовете команду.
```

Поля фронтматтера:

| Поле | Зачем |
| --- | --- |
| `name` | Имя команды, если оно должно отличаться от имени файла. По умолчанию команда называется как файл без расширения. |
| `description` | Что делает команда — показывается рядом с ней в списке `/`. |
| `argument-hint` | Подсказка об ожидаемых аргументах, видна при выборе команды через `/`. |
| `model` | Модель для этой команды — одна или список; используется первая доступная. |
| `tools` | Инструменты, доступные при выполнении команды. |
| `agent` | Кастомный агент, который выполнит команду, если нужен не тот, что выбран в чате сейчас. |

Тело файла ниже фронтматтера — сам промпт: то, что агент получит, когда вы вызовете команду.

## Где хранятся команды

WorkAI ищет файлы команд сразу в нескольких каталогах — сначала во всех проектных, потом во всех персональных. Внутри каждой группы порядок в таблице ниже — это и порядок поиска.

**Проектные** (лежат в git, работают у всей команды):

| Каталог | Расширение файла | Формат |
| --- | --- | --- |
| `.workai/commands/` | `.prompt.md` | Родной для WorkAI |
| `.github/prompts/` | `.prompt.md` | Родной, унаследован от GitHub Copilot |
| `.claude/commands/` | `.md` | Совместимость с Claude Code |
| `.cursor/commands/` | `.md` | Совместимость с Cursor |

**Персональные** (действуют во всех ваших проектах):

| Каталог | Расширение файла | Формат |
| --- | --- | --- |
| `~/.workai/commands/` | `.prompt.md` | Родной для WorkAI |
| `~/.claude/commands/` | `.md` | Совместимость с Claude Code |
| `~/.cursor/commands/` | `.md` | Совместимость с Cursor |

Расширение важно: `.workai/commands/review.md` без `.prompt.md` командой не станет — родной формат WorkAI и унаследованный от Copilot `.github/prompts/` ждут именно `*.prompt.md`. Голый `.md` распознаётся только в двух каталогах совместимости — тех, что уже используют Claude Code и Cursor.

Если вы уже завели команды для Claude Code или Cursor, дублировать их не нужно — WorkAI прочитает их из тех же каталогов, где они уже лежат.

## Как создать команду

Быстрее всего — встроенный скилл `/create-prompt`: опишите словами, какая команда нужна, и агент соберёт файл сам, с корректным фронтматтером и по нужному пути. Либо заведите файл руками по одному из путей выше.

## Команды и навыки — в чём разница

- **Команда** вызывается только явно, по имени через `/`. Это фиксированный шаблон промпта под конкретный, заранее известный сценарий.
- **Навык** агент может подгрузить сам, если его `description` подходит текущей задаче — вам не нужно помнить имя и вызывать его руками.

Если вы точно знаете, когда захотите этот промпт, и всегда вызываете его сами — заводите команду. Если процедура должна сработать без явного вызова, когда агент сам увидит подходящую задачу, — это [навык](/docs/skills).

## Дальше

- Полный список встроенных команд чата — [Слэш-команды](/docs/reference/slash-commands)
- Навыки и правила — [Навыки](/docs/skills), [Правила](/docs/rules)
- Обзор способов настройки агента — [Настройка](/docs/customization)