Кейсы использования¶
Ниже — практические сценарии, для которых Koda Desktop особенно полезен. Каждый кейс можно начинать с режима Только чтение, а правки разрешать только после понятного плана.
Быстрый онбординг в проект¶
Когда вы открыли незнакомый репозиторий, попросите обзор:
Объясни структуру проекта для нового разработчика: точки входа, основные модули, где лежат настройки, как примерно проходит пользовательский сценарий.
Продолжение:
Поиск причины бага¶
Подходит, когда есть симптом, лог или скриншот.
Найди причину бага по этому симптому: кнопка сохранения иногда не активируется после изменения поля. Сначала без правок, покажи цепочку файлов и наиболее вероятную точку отказа.
После анализа:
Если есть скриншот, приложите его к первому сообщению. Так агент увидит точный экран, а не только описание симптома.
Безопасный рефакторинг¶
Используйте, когда код работает, но его нужно упростить.
Посмотри этот модуль и предложи рефакторинг без изменения поведения. Раздели обязательные изменения и косметику. Код пока не меняй.
Затем можно разрешить только узкую часть:
Добавление тестов¶
Если в проекте уже есть тестовая инфраструктура:
Если тестов нет:
Проверь, есть ли в проекте тестовая инфраструктура. Если нет, предложи самый лёгкий способ проверить этот модуль без внедрения большого фреймворка.
Для таких задач удобно выбрать режим Тестировщик. Он держит фокус на сценариях, регрессиях и проверках, а не только на реализации.
Подготовка PR¶
Когда изменения уже сделаны:
Для описания:
Для предварительного ревью выберите режим Код-ревьюер. Он должен начинать с багов, рисков и недостающих проверок.
Документация и инструкции¶
Koda Desktop удобно использовать для пользовательских инструкций, README, runbook и release notes.
Обнови документацию для пользователя: объясни сценарий от установки до первого результата, добавь частые ошибки и короткие примеры запросов.
Для технической инструкции:
Собери runbook для диагностики этой ошибки: признаки, где смотреть логи, какие команды запускать, когда эскалировать.
Если есть требования в DOCX или PDF, приложите документ и попросите пересказать его как пользовательский сценарий. Это помогает быстро отделить “что нужно человеку” от технической реализации.
Работа с UI-копирайтом¶
Для интерфейсных текстов просите сразу несколько вариантов:
Предложи 5 коротких вариантов текста для пустого состояния. Тон: спокойный, рабочий, без шуток. Ограничение: до 70 символов.
Для русскоязычного продукта:
Проверь эти тексты интерфейса на ясность и единый стиль. Сохрани русский-first тон, не делай формально.
Разбор сборки или запуска¶
Когда что-то не собирается:
По этому логу найди первопричину. Не исправляй сразу: отдели главный сбой от последующих ошибок и предложи минимальный следующий шаг.
После правки:
Эксперименты во временной папке¶
Кнопка Без проекта подходит для быстрых проб:
- набросать пример компонента;
- сравнить два подхода;
- сгенерировать маленький скрипт;
- подготовить текст или структуру документа;
- разобрать идею до того, как переносить её в реальный репозиторий.
Пример:
Сделай маленький прототип функции нормализации данных на TypeScript и покажи 3 примера входа/выхода.
Если временная папка исчезла после перезапуска системы, приложение восстановит управляемую папку перед запуском агента. Удалять временный проект из боковой панели стоит только тогда, когда связанные чаты больше не нужны.
Работа с вложениями¶
Когда задача зависит от материалов, которые трудно пересказать, начинайте с вложения.
Примеры: