раздел 01

Как пользоваться

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

Открыть Composer

Composer вызывается иконкой Composer в интерфейсе Cursor или горячей клавишей - обычно Cmd+I на macOS. Откроется панель, куда вы пишете задачу.

Рабочий цикл

1
Открыть Composer
Иконка Composer или Cmd+I на macOS. Появляется поле для задачи.
2
Дать задачу
Опишите словами, что нужно сделать. Чем конкретнее, тем точнее результат.
3
Добавить контекст через @
Через @ подкиньте нужные файлы, папки или доки, чтобы агент видел, с чем работает.
4
Агент генерирует изменения
Он сам создаёт и правит файлы по задаче и показывает диффы по каждому из них.
5
Просмотреть и применить
Прочитайте диффы. Примите нужные изменения, лишние - откатите.

Контекст через @

Чтобы агент работал по делу, дайте ему контекст. В поле задачи наберите @ и выберите, что подкинуть:

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

Без контекста агент догадывается о структуре проекта сам и чаще ошибается.

Точный контекст - половина результата. Покажите агенту нужные файлы через @, и он перестанет угадывать.

Диффы: принять или откатить

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

  • Принять - изменение применяется к файлу.
  • Откатить - изменение отменяется, файл остаётся как был.

Можно принять часть, а часть откатить. Это и есть главная страховка: ничего не попадает в проект, пока вы не согласились.