Агентские навыки Koda

Коллекция навыков (skills) для AI-ассистента Koda.

• Официальный сайт: https://kodacode.ru
• Скачать Koda для JetBrains, VSCode или CLI: https://download.kodacode.ru
• Сообщество в Telegram: @kodacommunity

Введение

Навыки — это переиспользуемые наборы инструкций.
Когда задача соответствует описанию навыка, модель вызывает соответствующий инструмент и загружает полные инструкции.
В запросах к моделям также можно явно указывать требования запуска нужного навыка.

Поддержка навыков продуктами Koda:

• плагин с версии 0.7.0 (VSCode/JetBrains)
• koda-cli с версии 0.3.0

Быстрый старт

Установка навыка для установки навыков :)

1. Создайте файл в домашней директории:
   • Linux/MacOS: ~/.koda/skills/koda-learn/SKILL.md
   • Windows: %USERPROFILE%\.koda\skills\koda-learn\SKILL.md
2. Скопируйте в этот файл содержимое по ссылке и сохраните
3. Активируйте:
   • плагин: в режиме "Агент" на панели "Навыки" нажмите кнопку "Обновить список навыков"
   • koda-cli: выполните команду /skill enable koda-learn

Так вы сможете просто попросить любую модель в Koda установить навык для решения какой-либо задачи.
Так навык будет установлен в директорию текущего проекта (локально), поскольку Koda не имеет доступа к файловой системе за его пределами.

Аналогично можно установить любой другой навык из этого репозитория.
Ниже расписаны некоторые подробности.

Установка

Навыки должны располагаться по следующим путям:

Для глобальной установки (для всех проектов) директорию навыка следует располагать в домашней директории:

• Linux/MacOS: ~/ или $HOME
• Windows: %USERPROFILE%

Например: %USERPROFILE%\.agents\skills\koda-learn\SKILL.md

Для локальной установки (для одного проекта) достаточно скопировать навык в соответствующую папку в корне этого проекта.

Активация

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

После установки, обновления или удаления навыков следует нажать кнопку обновления списка в панели Навыки (режим Агент).

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

В koda-cli требуется ручное включение навыков:

• при незапущенном koda: koda skills enable <имя_навыка>
• при запущенном koda:
  • /skill reload
  • /skill enable <имя_навыка>

Если вы не видите навык в списке /skill list (koda skills list), обновите список: /skill reload

Формат SKILL.md

Каждый навык содержит YAML frontmatter с метаданными:

---
name: skill-name          # Идентификатор (kebab-case, 1-64 символов)
description: Описание     # Когда срабатывает и что делает (1-1024 символов)
metadata:
  author: koda
  version: "1.0.0"
---

Требования к имени:

• ✅ Валидно: code-review, sprint-planner, github-flow
• ❌ Невалидно: Code-Review (верхний регистр), -my-skill (дефис в начале), my--skill (двойной дефис)

Обслуживание репозитория

Автоматическое обновление

При пуше в ветку main срабатывает workflow .github/workflows/generator.yml, который:

1. Запускает скрипт генерации metadata.json
2. Создаёт коммит с обновлённым metadata.json (если есть изменения)
3. Использует сообщение вида: Update metadata 2024-01-01T00:00:00Z

Генерация metadata.json

Файл metadata.json содержит метаданные всех навыков репозитория и автоматически обновляется при пуше в ветку main через GitHub Actions.

Команды Makefile

help            Показать справку по командам
install         Подготовить виртуальное окружение генератора
metadata        Запустить генерацию metadata.json
clean           Удалить виртуальное окружение генератора

Структура metadata.json

{
  "skills": [
    {
      "name": "skill-name",
      "description": "Описание навыка",
      "version": "1.0.0",
      "url": {
        "web": "Ссылка на файл SKILL.md для просмотра в браузере",
        "raw": "Ссылка на сырой файл SKILL.md для установки"
      }
    }
  ],
  "count": 8,
  "lastUpdate": "2024-01-01T00:00:00Z"
}

Подробная схема описана в ./metadata-schema.json.

Лицензия

Содержимое репозитория распространяется на условиях лицензии MIT