Слеш-команды (промпты)¶

Это специальные заготовки промптов, которые начинаются с символа / и позволяют быстро выполнять предопределённые действия в Koda. Они доступны в режимах Чат и Агент.

Слеш-команды упрощают работу с AI, предоставляя готовые сценарии для типовых задач.

Каждая команда должна иметь уникальное имя и описание.

Как использовать¶

1. Введите / в поле ввода чата
2. Выберите команду из выпадающего списка
3. Нажмите Enter

Перед этим можно выделить часть текста в редакторе и нажать Ctrl/⌘ + L. Тогда выделенный текст будет подготовлен для отправки в следующем сообщении. Это позволит модели сфокусироваться на указанном участке.

Примеры: /explain, /review, /test

Встроенные команды¶

Koda поставляется с небольшим набором встроенных слеш-команд. Их невозможно переопределить или удалить.

/kodamd¶

Создаёт или обновляет контекстный файл KODA.md в корне текущего открытого проекта с описанием правил и технических подробностей.

Как работает:

1. Анализирует структуру проекта
2. Определяет технологии и фреймворки
3. Создаёт файл KODA.md с правилами
4. Добавляет лучшие практики для проекта

Результат:

# KODA.md — Правила проекта

## Технологии
- TypeScript
- React
- Node.js

## Стиль кода
- Использовать ESLint
- Следовать Airbnb Style Guide

## Структура
- Компоненты в `/components`
- Хуки в `/hooks`

/summarize¶

Сжимает контекст, создавая краткий конспект всего диалога для экономии токенов.

Когда использовать:

• Диалог стал слишком длинным (>20 сообщений)
• Предупреждение о переполнении контекста (75%+)
• Завершение этапа работы
• Перед переключением на новую задачу
• Хотите сохранить ключевые решения

Как работает:

1. Анализирует всю историю диалога
2. Выделяет ключевые решения и изменения
3. Сохраняет информацию о файлах и инструментах
4. Создаёт краткий конспект (до 500 слов)
5. Добавляет summary сообщение в историю

Результат: сжатие контекста около 50%.

Автоматическая суммаризация:

• Срабатывает при 75% использования контекста
• Только в агентском режиме
• Настраивается через settings.autoSummarize

Пользовательские команды¶

Вы можете создавать собственные слеш-команды в конфигурации. Причём как глобально, для использования только на своей машине, так и в репозитории проекта.

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

Создание глобальной команды¶

Файл: ~/.koda/config.yaml

prompts:
  - name: review
    description: Код-ревью (это поле необязательно)
    prompt: |
      Проведи код-ревью: найди сложный код, уязвимые места, необработанные ошибки.
      Аргументируй, и предложи варианты решения.
      Не изменяй файлы на диске, ожидай ответа.

Создание локальной команды¶

Файл: <workspace>/.koda/prompts/my-command.prompt

---
# после сохранения этого файла можно будет использовать команду /explain
name: explain (1)
description: Объяснение кода (2)
temperature: 0.7 (3)
maxTokens: 4000 (4)
---
<system> (5)
Ты - опытный Python-разработчик, который умеет объяснять сложный код простыми словами.
</system>

(6) Проанализируй следующий код и предложи улучшения:

@currentFile (7)

1. Необязательно. Команда будет выглядеть как /explain, а если не указано, то /my-command по имени файла.
2. Необязательно. Просто подсказка для вас, которая будет отображаться в списке.
3. Необязательно. Параметр температуры для модели.
4. Необязательно. Ограничение длины ответа в токенах.
5. Необязательно. Полное переопределение системного промпта.
6. Обязательно. Текст промпта.
7. Необязательно. Контекст-провайдер для автоматического дополнения контекста.

Использование:

1. Выделите код и нажмите Ctrl/⌘ + L для добавления к новому сообщению
2. Введите /explain
3. Нажмите Enter

Примеры команд для рефакторинга и документации кода:

prompts:
  - name: "refactor"
    description: "Рефакторинг кода"
    prompt: "Улучши этот код: сделай его чище, производительнее и читаемее. Объясни изменения."
  - name: "doc"
    description: "Создать документацию"
    prompt: "Создай документацию для этого кода в формате JSDoc"

Использование:

/refactor
/doc

Динамические промпты¶

Используйте шаблоны для динамических промптов:

prompts:
  - name: "commit"
    description: "Сгенерировать сообщение коммита"
    prompt: "Создай сообщение коммита без использования conventional commits на основе этих изменений: {{diff}}"

Переменные:

• {{diff}} — текущие изменения
• {{file}} — текущий файл
• {{selection}} — выделенный текст

Команды из MCP-серверов¶

MCP-серверы могут предоставлять свои слеш-команды.

При подключении такого MCP-сервера они автоматически становятся доступны в чате.

Приоритет команд¶

Если команды имеют одинаковые имена:

1. Пользовательские команды имеют приоритет
2. MCP команды переопределяют встроенные
3. Последние загруженные имеют приоритет

Лучшие практики¶

1. Именование команд¶

✅ Хорошо:

• /refactor — понятно
• /doc — кратко
• /test-unit — специфично

❌ Плохо:

• /do-the-thing — непонятно
• /my-super-command-123 — слишком длинно
• /test — слишком обще (если есть /test-unit, /test-e2e)

2. Описание команд¶

✅ Хорошо:

description: "Рефакторинг кода с улучшением читаемости"

❌ Плохо:

description: "test123"

3. Промпты¶

✅ Хорошо:

prompt: "Улучши этот код: сделай его чище и производительнее. Объясни каждое изменение."

❌ Плохо:

prompt: "Сделай код лучше"