Использование навыков в Kimi Code

Kimi Code — AI-помощник для программирования, созданный специально для разработчиков. Он работает прямо в терминале или редакторе и помогает писать код, исправлять ошибки и готовить документацию. Kimi Code поддерживает рекомендации на основе знаний через файлы SKILL.md: прочитав их, AI следует заданным в них стандартам. Это удобно для описания стиля кода, рабочих процессов и лучших практик.

Вызов навыков с помощью slash-команды

Вызов навыков

Kimi Code CLI позволяет вызывать навыки с помощью slash-команд:

Bash

Например, если ввести /skill:git-commits, Kimi Code прочитает содержимое соответствующего файла SKILL.md и отправит его агенту как инструкцию.

После slash-команды можно добавить дополнительное описание — оно будет присоединено к инструкции навыка в конце:

Bash

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

Создание первого навыка

Чтобы создать навык, достаточно двух шагов: создать подкаталог в каталоге Skills, а внутри него — файл SKILL.md.

Рекомендуемое место хранения (работает для всех проектов):

Text

В SKILL.md метаданные задаются через YAML Frontmatter, а основные правила описываются в Markdown:

Markdown

Поля name и description во Frontmatter необязательны. Если их не указать, по умолчанию будет использовано имя каталога.

Пример

В вашей команде сообщения коммитов должны соответствовать формату Conventional Commits, но каждый раз объяснять это неудобно. Оформив правило как навык, в дальнейшем вы сможете вызывать его одной командой.

Шаг 1. Создайте файл навыка

Markdown

Шаг 2. После внесения изменений в код вызовите навык

Bash

Kimi Code прочитает ваши стандарты, объединит их с описанием задачи и сразу выдаст корректно оформленное сообщение коммита — вам не придётся заново перечислять требования к формату.

Потоковые навыки: многошаговые рабочие процессы

Обычные навыки задают статические правила, а потоковые навыки позволяют описывать автоматизированные многошаговые процессы.

Чтобы создать потоковый навык, укажите type: flow во Frontmatter и добавьте блок-схему в формате Mermaid или D2.

Markdown

Запускайте такой навык командой /flow:<name>. Агент начнёт с узла BEGIN и автоматически выполнит все шаги по порядку, пока не дойдёт до END.

Механизм загрузки навыков

Kimi Code CLI ищет и загружает навыки в следующем порядке приоритета (первым используется первое совпадение):

  1. Встроенные навыки: устанавливаются вместе с пакетом и предоставляют базовые возможности.
  2. Навыки уровня пользователя: хранятся в домашнем каталоге и доступны во всех проектах.
  3. Навыки уровня проекта: хранятся в каталоге проекта и доступны только в этом проекте.

Дополнительные каталоги с навыками можно указать вручную с помощью параметра --skills-dir:

Bash

В Kimi Code CLI есть два полезных встроенных навыка: kimi-cli-help (отвечает на вопросы по использованию CLI) и skill-creator (помогает создавать новые навыки). Чтобы начать, введите /skill:skill-creator.

Полный список настроек и пояснения к параметрам см. в документации по навыкам Kimi Code CLI.