Свои команды и агенты

Если часто просите агента об одном и том же, сделайте из этой просьбы команду: сохраните текст запроса в файл и вызывайте его как /имя. Если нужен помощник с отдельной ролью, например ревьюер, опишите его как своего агента, и основной агент поручит ему часть работы. И команды, и агенты — обычные Markdown-файлы в домашней папке. В путях ниже домашняя папка — это ~. На Windows команды лежат в %USERPROFILE%\.koder\commands, агенты — в %USERPROFILE%\.koder\agents.

#Свои команды

#Как создать

1. Создайте файл ~/.koder/commands/<имя>.md. Имя — до 64 знаков из строчных латинских букв, цифр и дефиса; первый знак — буква или цифра. Например, ~/.koder/commands/pre-commit.md.

2. Напишите в нём описание и текст запроса:

   ---
   description: Проверить изменения перед коммитом
   ---
   
   Посмотри незакоммиченные изменения (`git diff`) и проверь их: ошибки, забытые отладочные
   выводы, тесты для нового кода. Особое внимание: $ARGUMENTS
   

3. Перезапустите DevMachine. Команда появится в списке «/». Если её нет, проверьте имя файла: DevMachine берёт только файлы .md с именем по правилам шага 1 и не показывает команды с именами встроенных (совет ниже).

• description — подпись команды в списке «/».
• $ARGUMENTS — сюда подставится текст, который напишете после имени команды.

#Как вызвать

Наберите / в начале поля ввода и выберите команду в списке или напишите её целиком: /pre-commit миграции. Текст команды уйдёт агенту как ваше сообщение, а на месте $ARGUMENTS встанет «миграции».

#Как изменить или удалить

Поправьте или удалите файл в ~/.koder/commands и перезапустите DevMachine. При каждом запуске DevMachine заново читает команды из этой папки, поэтому удалённая команда пропадает из списка.

#Свои агенты

Свой агент — это роль с отдельной инструкцией. Основной агент запускает его как субагента: передаёт задачу, а субагент ведёт с моделью отдельный разговор и возвращает короткий итог, поэтому подробности не засоряют основной чат. Такому агенту удобно поручать работу, где нужен свой взгляд или свои правила.

#Как создать

1. Создайте файл ~/.koder/agents/<имя>.md. Правила для имени те же, что у команд.

2. Опишите роль:

   ---
   name: reviewer
   description: Ревьюер кода. Используй после правок, чтобы найти ошибки и пропущенные тесты.
   mode: subagent
   ---
   
   Ты ревьюер. Прочитай изменения и найди ошибки, рискованные места и код без тестов.
   Сам ничего не исправляй — верни список замечаний с файлом и строкой.
   

3. Перезапустите DevMachine.

• name — имя агента.
• description — по этому описанию основной агент решает, когда звать помощника. Пишите, что он делает и когда нужен.
• mode: subagent — агент работает помощником основного. Поле необязательно: без него агент тоже станет помощником, а с mode: primary основной агент его не позовёт.

#Как вызвать

Основной агент сам зовёт субагента, когда задача подходит под описание. Можно попросить и прямо: «Отдай изменения на ревью субагенту reviewer». Как работают субагенты и где видно, что они делают, — на странице Субагенты и фоновые задачи.

Свой агент работает только помощником: своего основного агента в DevMachine выбрать нельзя. Режимы основного агента тоже только встроенные: «Авто», «Полный», «План» и «Без ограничений». Они задают, как часто агент спрашивает разрешения. Подробнее о них — на странице Режимы агента.

#Модель субагентов

Модель для субагентов можно выбрать в «Настройки → Аккаунт и тариф»: блок «Расход лимита», строка «Модель для помощников агента».

Настройка действует сразу, перезапускать DevMachine не нужно. Про выбор моделей — на странице Модели.

#Ограничения

• Команды и агенты хранятся только на этом компьютере.
• Новые и изменённые файлы DevMachine подхватывает после перезапуска.
• Из репозитория DevMachine команды и агентов не загружает — только ваши, из ~/.koder/commands и ~/.koder/agents. Подробнее — Правила проекта.
• Текст команды уходит модели как ваше сообщение, а инструкция своего агента — в запросе субагента к модели.

#Что дальше

• Навыки — инструкции, которые агент берёт сам, когда они нужны для задачи.
• Команды «/» — встроенные команды DevMachine.
• Субагенты и фоновые задачи — как агент делит работу.
• Модели — модель чата и модель «Авто».