Учебник

Cursor Composer и Agent Mode: пишем целые фичи одной командой

Как использовать Composer для многофайловых изменений и Agent Mode для автономного решения задач: практические кейсы и подводные камни.

Макс Космов··2 мин чтения

Cursor Composer в сочетании с Agent Mode позволяет генерировать полностью готовый функционал одним запросом: вы описываете желаемую фичу, а система автоматически пишет код, создаёт тесты и интегрирует его в проект. Это ускоряет разработку, избавляя от рутинных шагов и позволяя сконцентрироваться на бизнес‑логике.

до про · Cursor

Composer vs Chat: когда что использовать

Composer – это режим, в котором Cursor воспринимает ваш запрос как «задание» и генерирует готовый набор файлов, функций или даже целый проект. Он ориентирован на масштабные, структурированные изменения: добавление новой подсистемы, рефакторинг крупного кода, создание API‑эндпоинтов, генерацию тестов для всей библиотеки.

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

Когда выбирать Composer

  1. Новый модуль или микросервис Если нужно добавить в проект полностью новый модуль (например, «модуль аутентификации с JWT»), сформулируйте задачу в виде:
Создай пакет auth, включающий модели User, сервис TokenService, контроллер /login и unit‑тесты.

Composer создаст структуру каталогов, файлы и подключит их к сборке.

  1. Рефакторинг большого кода Когда требуется изменить архитектуру (перевести монолит в слоистую структуру) – задайте цель, а не отдельные шаги. Composer выполнит переименование, перемещение файлов и обновит импорты автоматически.

  2. Генерация шаблонов Для создания шаблонов (CRUD, GraphQL‑резолверы, Dockerfile) достаточно одного запроса. Composer выдаст готовый набор файлов, готовый к коммиту.

  3. Тестовое покрытие Если нужен набор тестов для всего пакета, укажите: «Сгенерируй unit‑тесты для всех функций в src/utils». Composer проанализирует код и создаст тесты, включив их в конфигурацию тест‑раннера.

  4. Миграции и скрипты При необходимости добавить миграцию БД, скрипт деплоя или CI‑pipeline, Composer сформирует файлы и обновит соответствующие конфиги.

Когда выбирать Chat

  1. Быстрая правка Нужно поправить одну строку, добавить проверку или изменить название переменной – задайте вопрос в чате. Ответ придёт сразу, без необходимости пересоздавать файлы.

  2. Уточнение детали Если после генерации Composer вы видите, что часть кода не соответствует требованиям, задайте уточняющий вопрос: «Почему в TokenService используется HS256, а нужен RS256?».

  3. Объяснение кода Для понимания чужого фрагмента, запросите разбор: «Объясни, как работает функция parseJwt». Chat вернёт пояснение, комментарии и возможные улучшения.

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

  5. Консультация по лучшим практикам Если сомневаетесь в выборе библиотеки или паттерна, спросите в чате: «Какая библиотека лучше для валидации схем в Node.js?».

Комбинирование режимов

Часто оптимальный workflow выглядит так:

  1. Composer – создаёт базовую структуру (модуль, API, тесты).
  2. Chat – уточняет детали, исправляет мелкие недочёты, обсуждает альтернативы.
  3. При необходимости Composer запускается повторно с уточнённым запросом, а Chat остаётся вспомогательным каналом.

Практический совет

  • Определите гранулярность задачи. Если запрос охватывает более 5 файлов или требует изменения конфигураций,