Лучшие практики работы с Клёпой
Как использовать режимы плагина, чтобы быстрее проектировать, писать, проверять и улучшать код.
Как работать с Клёпой эффективно
Клёпа лучше всего работает, когда вы подбираете режим под конкретную задачу. Не пытайтесь решать всё одним и тем же способом: сначала спланируйте, затем уточните требования, после кодируйте, а для проверки используйте Debug и Review.
Режимы и когда их использовать
Режим предварительного проектирования. Помогает сформировать архитектуру, выбрать подход и разложить задачу до начала написания кода.
- нужно продумать структуру новой функции или сервиса
- требуется оценить несколько вариантов решения
- нужно зафиксировать ограничения и допущения
Основной режим для написания, изменения и рефакторинга кода. Лучше всего работает, когда задача уже понятна и есть чёткий контекст.
- нужно реализовать готовую спецификацию
- требуется внести точечные изменения
- нужно отрефакторить участок кода без смены логики
Режим для вопросов, объяснений и проверки понимания. Используйте его, когда нужно разобрать концепцию без немедленной правки кода.
- нужно понять, как работает библиотека или API
- требуется объяснение архитектурного решения
- нужно быстро уточнить термин или подход
Режим для поиска причины ошибки, воспроизведения проблемы и подготовки исправления. Подходит, когда уже есть симптом и нужно найти источник сбоя.
- приложение падает или ведёт себя нестабильно
- нужно найти причину некорректного результата
- требуется проверить логи, трассировку или окружение
Режим-координатор для сложных задач. Помогает распределять работу между Architect, Code, Ask, Debug и Review.
- задача большая и многошаговая
- нужно вести работу в нескольких режимах подряд
- требуется удерживать общий план и последовательность действий
Режим локальной проверки изменений. Полезен после реализации, когда нужно оценить качество кода, найти недочёты и подтвердить готовность к merge.
- нужно проверить diff перед отправкой
- важно найти мелкие ошибки и регрессии
- требуется финальная оценка качества изменений
Практические сценарии
Сначала задайте архитектурные границы, затем уточните требования, после этого переходите к реализации и финальной проверке.
При отладке не начинайте с переписывания. Сначала диагностируйте проблему, затем внесите минимальное исправление и проверьте результат.
Для большого объёма работ удобнее держать один управляющий режим, который координирует этапы и сохраняет общий контекст.
Ключевые выводы
Готовы применить?
Откройте Клёпу в VS Code и попробуйте подобрать режим под текущую задачу. Marketplace добавит готовые режимы под конкретные роли.