Режим чата¶

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

Когда чат особенно полезен¶

Чат хорошо работает в тех ситуациях, где важен диалог, а не одноразовая подсказка:

• нужно быстро разобраться в незнакомом участке кода;
• хочется спросить, почему что-то ломается;
• нужен пример, заготовка или направление для рефакторинга;
• хочется обсудить несколько вариантов решения перед изменениями.

Проще всего думать о нём так: это рабочее пространство для разговора с моделью о вашем проекте.

Как начать¶

1. Откройте панель Koda.
2. Нажмите Ctrl/⌘ + L, если используете горячие клавиши.
3. Напишите первый запрос обычным языком.

Например:

Объясни, что делает этот сервис и где в нём могут быть слабые места

Или так:

Помоги упростить этот компонент без изменения поведения

Как получить более точный ответ¶

Самый заметный рост качества обычно даёт не «магический промпт», а хороший контекст.

Добавляйте контекст через @¶

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

Примеры:

@src/auth/service.ts Проверь, почему здесь иногда появляется 500 ошибка

@terminal Взгляни на упавшие тесты и проверь в чём ошибка

@problems Объясни, что означают эти ошибки TypeScript и с чего начать исправление

Подробнее о выборе контекста — через @ в начале запроса.

Продолжайте разговор, а не начинайте заново¶

Если ответ получился слишком общим, не обязательно переписывать запрос с нуля. Часто достаточно уточнить направление:

Покажи более практичный вариант для production-кода

Не переписывай всё, измени только логику валидации

Объясни проще, как для разработчика, который впервые видит этот код

Именно в таких коротких уточнениях чат особенно силён.

Типовые сценарии¶

Разобраться в коде¶

@src/utils/parser.ts Объясни, что делает эта функция и какие у неё пограничные случаи

Найти причину ошибки¶

@problems @src/api/users.ts Почему здесь может возникать эта ошибка и как бы ты её отлаживал?

Попросить пример¶

Покажи аккуратный пример middleware для проверки JWT в Express и TypeScript

Подготовить рефакторинг¶

@code Предложи 2-3 варианта, как сделать этот код проще, но без изменения публичного API

Полезные привычки в чате¶

Формулируйте задачу чуть конкретнее¶

Сравните:

✅ Лучше:

Как отсортировать массив объектов по createdAt по убыванию в TypeScript?

❌ Слишком общо:

Как отсортировать массив?

Указывайте ограничения¶

Если есть важные рамки, лучше назвать их сразу:

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

Просите объяснить ход мысли результата, а не внутренние рассуждения¶

Хорошая формулировка:

Коротко объясни, почему ты предлагаешь именно такой вариант

Так проще проверить, насколько решение вам подходит.

Когда стоит начать новый чат¶

Новый диалог полезен, если:

• вы полностью сменили тему;
• в текущем разговоре накопилось слишком много несвязанного контекста;
• модель начала цепляться за старые предположения;
• хочется «чистого листа» для новой задачи.

Если ответы стали хуже¶

Чаще всего помогает одно из трёх действий:

1. добавить более точный контекст через @;
2. уточнить задачу в одном коротком сообщении;
3. начать новый чат, если тема уже ушла слишком далеко в сторону.

Если проблема не в формулировке, а в работе сервиса, загляните в раздел Решение общих проблем.

Что важно помнить¶

• не отправляйте в чат секреты, токены, пароли и другую чувствительную информацию;
• проверяйте сгенерированный код перед использованием;
• если задача уже требует не только ответа, но и серии действий, удобнее перейти в режим агента;
• если вы уже пишете код руками и нужен только следующий фрагмент, быстрее сработает автодополнение.