Skills — это переиспользуемые наборы инструкций для агента. Если задача пользователя совпадает с описанием навыка, модель автоматически подгружает его и использует как контекст. Это позволяет описывать типовые сценарии: работу с терминалом, планирование задач, запуск инструментов или любые внутренние процессы.
В KodaCode навыки можно включать, отключать и создавать собственные. На скрине показан пример списка skills — для bash/Linux, PowerShell, планирования реализации и других задач.
Skills (навыки) можно взять из открытого каталога skills.sh или любого другого публичного репозитория со скилами. Некоторые навыки под конкретную задачу удобно описать самостоятельно под свои сценарии.
Например, мы сделали простой skill, который при определённых условиях запускает koda-cli как субагента. Он формирует промпт, стартует отдельный процесс и продолжает работу, периодически проверяя, завершился ли субагент.
SKILL.md для Koda CLI Subagent
--- name: koda-cli-subagent description: 'Запуск экземпляров koda-cli для параллельной работы над сложными задачами' --- # Субагент koda-cli > Запуск экземпляров koda-cli для параллельной работы над сложными задачами ## Введение Этот навык позволяет запускать команду `koda-cli` через инструмент `run_terminal_command`. Этот навык предназначен для параллельного выполнения сложных задач. ## Когда применять 1. Выполняемая задача оказалась сложнее, чем предполагалось. 2. Есть чёткий план выполнения. 3. Об этом явно просит пользователь. ## Как применять ### 1. Подготовка промпта Для субагента потребуется промпт. Для его формирования следует использовать данные, полученные после анализа задачи и файлов. Это может быть часть заранее подготовленного плана. В промпте обязательно должны быть указаны: * цель изменений; * пути к файлам, которые требуется прочесть или изменить, относительно корня текущего проекта; * имена классов, процедур, функций, переменных и прочих синтаксических конструкций; * дополнительные сопутствующие указания, например, обновить doc-блоки комментариев к методу класса после изменения сигнатуры или тела метода. Передача промпта субагенту показана ниже с помощью переменной `$PROMPT_TEXT`. ### 2. Подготовка к запуску Эти шаги можно не выполнять, если пользователь явно указал, что команда `koda` установлена или этот навык уже применялся и все проверки пройдены. 1. Необходимо убедиться, что у пользователя в системе доступна команда `koda`: * для Windows: `Get-Command koda` * для MacOS/Linux: `hash koda && koda --version` 2. Если команды `koda` нет, тогда проверить наличие `npm`: * для Windows: `Get-Command npm` * для MacOS/Linux: `hash npm && npm --version` 3. Если команда `npm` есть, тогда установить: `npm install --global @kodadev/koda-cli@latest` 4. Если команды `npm` нет и/или возникла ошибка установки, выполняй задачу самостоятельно. ### 3. Запуск субагента Запускать субагента следует командой: ```bash koda --model koda-pro --approval-mode auto_edit --checkpointing --prompt <<'EOF' $PROMPT_TEXT ЗАПРЕЩЕНО выполнять опасные операции над файловой системой и операционной системой. EOF ``` Если не возникло ошибок при запуске, следует переключить выполнение команды в фоновый режим. Не жди завершения и выполняй другую часть задачи дальше, если возможно. Если возникли ошибки, выполняй всю задачу самостоятельно. ### Обработка результата 1. Ты должен проверить завершена ли работа субагентов. 2. Ты должен проверить результат работы каждого субагента и оценить внесённые ими изменения. 3. По внесённым изменениям ты должен оценить выполнена ли поставленная задача. 4. Если задача не выполнена, следует скорректировать `$PROMPT_TEXT` соответствующим образом, снова вызвать субагента и ожидать завершения его работы. 5. В конце ты должен составить протокол обо всех внесённых изменениях, успешных или неуспешных, составить рекомендации и предоставить пользователю.
Если вы ранее устанавливали skills для других приложений, они автоматически подтянутся из глобальной директории ~/.agents/skills.
Также добавили поддержку AGENTS.md. Это файл инструкций для AI-агентов внутри репозитория. По сути это README для модели: в нём можно описать архитектуру проекта, правила работы с кодом, команды запуска, ограничения и любые другие указания, которые агент должен учитывать.
Скачивайте и пользуйтесь KodaCode уже сейчас: https://download.kodacode.ru
И подписывайтесь на наш ТГК, чтобы не пропустить новую информацию про Koda, AI и всё что с ними связано!
