Команды

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

Не путайте со встроенными командами чата вроде /clear или /models — тот список зашит в клиент и описан в справочнике слэш-команд. На этой странице — про ваши собственные команды, которые вы заводите файлами в проекте или в профиле.

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

---
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 подходит текущей задаче — вам не нужно помнить имя и вызывать его руками.

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

Дальше #

• Полный список встроенных команд чата — Слэш-команды
• Навыки и правила — Навыки, Правила
• Обзор способов настройки агента — Настройка