Навыки и команды

Навыки и команды это твои собственные расширения агента в виде Markdown-файлов. Механизм у них общий: команда одновременно работает и как навык, поэтому агент может подтянуть её сам по описанию, а ты можешь вызвать вручную через `/имя`. ## Свои команды Команда это Markdown-файл в каталоге `commands/` (внутри `.waibee/` или `.claude/`, в проекте или глобально в `~`). Имя файла становится именем команды: `review.md` вызывается как `/review`. Подкаталог добавляет префикс: `deploy.md` в `commands/ops/` вызывается как `/ops:deploy`. Тело файла это шаблон запроса, который подставляется при вызове. Аргументы: - `$ARGUMENTS` подставляет всю строку после имени команды, - `$1`, `$2` подставляют отдельные аргументы по порядку, - `` !`команда` `` вставляет вывод shell-команды на момент вызова. Необязательный frontmatter настраивает команду: ```markdown --- description: Короткое описание для списка команд argument-hint: <ветка> allowed-tools: Read, Grep, Bash --- Проверь ветку $1 на конфликты с main и опиши, что нужно поправить. ``` - `description` показывается в списке команд. - `argument-hint` подсказывает, какие аргументы ожидаются. - `allowed-tools` ограничивает набор инструментов на время выполнения команды. ## Навыки Навык это команда с дополнительными файлами рядом: каталог `.waibee/skills/<имя>/` с файлом `SKILL.md` и любыми вспомогательными материалами. `SKILL.md` описывает, что умеет навык, а его полный текст подгружается только при необходимости. ```markdown title="SKILL.md" --- name: deploy description: Деплой текущей ветки на staging allowed-tools: [Read, Bash, Edit] argument-hint: "[окружение]" --- Когда просят задеплоить: покажи git status, прогони тесты, затем деплой. ``` Поля frontmatter: `name`, `description`, `allowed-tools`, `argument-hint` и `user-invocable` (по умолчанию `true`). Короткие описания всех навыков агент держит в контексте постоянно, а полное содержимое подтягивает, лишь когда навык нужен. Так знания под конкретную задачу не занимают место в каждой сессии. ## Субагенты Субагент это отдельный помощник с урезанным набором инструментов, которого основной агент запускает инструментом `Task` под узкую задачу в изолированном контексте. Описание кладётся в `.waibee/agents/<имя>.md`: ```markdown title=".waibee/agents/code-reviewer.md" --- name: code-reviewer description: Ревью диффа на корректность и стиль, без правок tools: [Read, Glob, Grep] --- Ты ревьюер. Прочитай дифф и отметь проблемы. Ничего не меняй. ``` ## Где всё это лежит Команды и навыки ищутся в проекте и глобально, в `.waibee/` и в совместимом `.claude/`. При совпадении имён приоритет такой: проект важнее глобального, `.waibee/` важнее `.claude/`. Список доступных команд показывает `/help`. Навыки и команды можно установить и целым набором, см. [Плагины](/code/plugins/). Файл можно не создавать руками: на странице расширений в [браузере](/code/web/) навык, команда или субагент заводятся по форме. По умолчанию файл ложится в папку той сессии, с которой ты работаешь, но можно выбрать и домашнюю: тогда он доступен во всех проектах. Там же любой из них выключается, не удаляя файл. Писать всё с нуля не обязательно: под частые задачи навыки уже есть. Каталоги и способы установки в разделе [Где искать расширения](/code/ecosystem/), готовые подборки в разделе [Подборка расширений](/code/toolkit/).

Свои команды

Команда это Markdown-файл в каталоге commands/ (внутри .waibee/ или .claude/, в проекте или глобально в ~). Имя файла становится именем команды: review.md вызывается как /review. Подкаталог добавляет префикс: deploy.md в commands/ops/ вызывается как /ops:deploy.

Тело файла это шаблон запроса, который подставляется при вызове. Аргументы:

$ARGUMENTS подставляет всю строку после имени команды,
$1, $2 подставляют отдельные аргументы по порядку,
!`команда` вставляет вывод shell-команды на момент вызова.

Необязательный frontmatter настраивает команду:

---
description: Короткое описание для списка команд
argument-hint: <ветка>
allowed-tools: Read, Grep, Bash
---
Проверь ветку $1 на конфликты с main и опиши, что нужно поправить.

description показывается в списке команд.
argument-hint подсказывает, какие аргументы ожидаются.
allowed-tools ограничивает набор инструментов на время выполнения команды.

Навыки

Навык это команда с дополнительными файлами рядом: каталог .waibee/skills/<имя>/ с файлом SKILL.md и любыми вспомогательными материалами. SKILL.md описывает, что умеет навык, а его полный текст подгружается только при необходимости.

---
name: deploy
description: Деплой текущей ветки на staging
allowed-tools: [Read, Bash, Edit]
argument-hint: "[окружение]"
---

Когда просят задеплоить: покажи git status, прогони тесты, затем деплой.

Поля frontmatter: name, description, allowed-tools, argument-hint и user-invocable (по умолчанию true).

Короткие описания всех навыков агент держит в контексте постоянно, а полное содержимое подтягивает, лишь когда навык нужен. Так знания под конкретную задачу не занимают место в каждой сессии.

Субагенты

Субагент это отдельный помощник с урезанным набором инструментов, которого основной агент запускает инструментом Task под узкую задачу в изолированном контексте. Описание кладётся в .waibee/agents/<имя>.md:

---
name: code-reviewer
description: Ревью диффа на корректность и стиль, без правок
tools: [Read, Glob, Grep]
---

Ты ревьюер. Прочитай дифф и отметь проблемы. Ничего не меняй.

Где всё это лежит

Команды и навыки ищутся в проекте и глобально, в .waibee/ и в совместимом .claude/. При совпадении имён приоритет такой: проект важнее глобального, .waibee/ важнее .claude/.

Список доступных команд показывает /help. Навыки и команды можно установить и целым набором, см. Плагины.

Файл можно не создавать руками: на странице расширений в браузере навык, команда или субагент заводятся по форме. По умолчанию файл ложится в папку той сессии, с которой ты работаешь, но можно выбрать и домашнюю: тогда он доступен во всех проектах. Там же любой из них выключается, не удаляя файл.

Писать всё с нуля не обязательно: под частые задачи навыки уже есть. Каталоги и способы установки в разделе Где искать расширения, готовые подборки в разделе Подборка расширений.