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

Это специальные заготовки промптов, которые начинаются с символа / и позволяют быстро выполнять предопределённые действия в 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% использования контекста
• Только в агентском режиме
• Управляется настройкой Автоматическое сжатие контекста на странице Пользовательские настройки
• Параметр конфигурации — autoSummarize

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

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

• Глобальные команды задаются в секции prompts файла ~/.koda/config.yaml.
• Локальные команды хранятся в отдельных .prompt-файлах в папке .koda/prompts/ проекта. Они поддерживают продвинутый синтаксис: переменные, условия, циклы и контекст-провайдеры.

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

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

после сохранения этого файла можно будет использовать команду /explain¶

name: explain (1) description: Объяснение кода (2) temperature: 0.7 (3) maxTokens: 4000 (4)

(5) Ты - опытный Python-разработчик, который умеет объяснять сложный код простыми словами.

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

@currentFile (7)

</div>

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

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

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

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

```yaml
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: "Сделай код лучше"