Перейти к содержанию

Навыки агента

Навык — это каталог с файлом SKILL.md, который содержит инструкции для модели по конкретному типу задач. Koda Desktop автоматически обнаруживает навыки при старте сессии и передаёт агенту их имена и описания. Когда запрос подходит под описание навыка, модель загружает его инструкции и следует им.

Общее устройство навыков описано в разделе Навыки

Там же приведены примеры и лучшие практики.

Расположение навыков

Koda Desktop сканирует несколько каталогов:

Источник Пути
Глобальные ~/.kodacli/skills
~/.agents/skills
Локальные (в проекте) .kodacli/skills
.koda/skills
.agents/skills

Глобальные навыки доступны во всех проектах, локальные — только в том проекте, где лежат. Если навыки с одинаковым именем есть в нескольких источниках, приоритет у локального.

Управлять навыками можно и через Koda CLI — например, установить навык из Git-репозитория командой koda skills install.

Подробности — в разделе Навыки агента документации CLI.

Включение навыков проекта

Локальными навыками проекта можно управлять прямо из чата. Если в проекте есть хотя бы один такой навык, над полем запроса появляется чип Навыки с количеством включённых навыков.

По клику на чип открывается список локальных навыков проекта с переключателями:

  • включённый навык агент может активировать автоматически;
  • выключенный навык не попадает в контекст агента.

Изменения сохраняются в файле .kodacli/settings.json в проекте:

.kodacli/settings.json
{
  "skills": {
    "disabled": ["my-skill"]
  }
}

Во время ответа агента переключение недоступно

Включать и выключать навыки можно после завершения ответа агента. Пока агент работает, чип остаётся неактивным.

Ограничение в режимах

В пользовательских режимах агента можно ограничить, какие навыки доступны агенту:

  • Все навыки — агент использует любые доступные навыки;
  • Выбрать вручную — можно включить только нужные навыки;
  • Пользовательский навык — можно добавить навык, который не был обнаружен автоматически.

Подробности в разделе Пользовательские режимы — Навыки.

Ограничение в задачах по расписанию

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

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

Подробности в разделе Задачи по расписанию.