oakmeet

Как пользоваться Cursor Agent: задача в репо и проверка diff

Откройте Agent, дайте одну ограниченную задачу в репо, затем сами прочитайте diff, прежде чем что-то оставлять.

Репозиторий уже открыт в Cursor. Нужно, чтобы модель работала — без принятия стопки непрочитанных diff. Официальная справка зовёт этот путь режимом Agent: открыть чат, дать одну задачу в репо, прочитать каждый затронутый файл.

Искомая работа — как пользоваться Cursor Agent: открыть панель Agent, обойти только читающий Ask, написать ограниченную задачу и в виде diff решить, что оставить. Сочетания и шаги проверки ниже — по cursor.com/help/ai-features/agent.

⌘IMac открывает Agent; Windows/Linux — Ctrl+I
4Режимы: Agent, Ask, Plan, Debug
1Одна задача в репо на новый чат

Выбрать режим, которому можно писать

Agent пишет

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

Ask только читает

Ask отвечает на вопросы и не правит. Если панель на Ask, будет объяснение и пустой diff. Shift+Tab крутит режимы; выпадающий список делает то же.

РежимКогдаМеняет файлы?
AgentФича, рефактор или фикс, который вы проверитеДа
AskНужно только понять деревоНет
PlanБольшое изменение на много файлов, сначала планПосле утверждения плана
DebugБаг, которому нужны доказательства во время выполненияДа

Один проход: старт, задача, проверка

  1. 01
    Открыть панель Agent

    В папке, которая уже git-репозиторий, Cmd+I (Mac) или Ctrl+I (Windows/Linux). Переключатель должен говорить Agent. Если прошлый тред был о другом, откройте новый чат. Официально: у каждого режима свой контекст; при смене задачи чище начать заново.

  2. 02
    Дать одну ограниченную задачу в репо

    Назвать итог, файлы или область и критерий готовности. Пример: проверка на null в src/auth/session.ts и прогон существующего юнит-теста. Не вставлять пять чужих дел. Официальный пример — одна конкретная просьба.

  3. 03
    Смотреть вид diff

    Return. Agent сначала ищет, затем применяет правки по ходу. Файлы открываются в diff. Stop, если он вышел из названной папки. Следующую реплику можно поставить в очередь до конца текущего прогона.

  4. 04
    Прочитать, затем оставить или отклонить

    Читать добавленные и удалённые строки. Отклонять ненужные куски. Навести на более раннее сообщение и Restore Checkpoint — файлы после этой точки откатятся, переписка останется. Тесты гоняйте сами; зелёная строка в журнале агента — не приёмка.

Добавить страж в src/auth/session.ts: без
user id вернуть 401. Папку billing не трогать.
Прогнать существующий юнит-тест session и
остановиться, если он падает.

Где первые задачи обычно ломаются

Панель стояла на Ask
Файлы не меняются. Переключите на Agent через Shift+Tab или список режимов и отправьте тот же запрос снова.
В запросе не было границы
Agent ищет широко. Назовите каталог, тест и пути, которые нельзя править.
Приняли всю стопку
Отклоните лишние файлы. Смотрите удаления. Если форма неверна, верните контрольную точку, а не наслаивайте вторую переписку на плохой патч.

Одна задача, один чат, затем читать diff. Кнопка принять — не ревью.

Cloud Agents — другая дверь

cursor.com/agents может запустить Cloud Agent из браузера. Настольный круг этого гида тот же: проверка ваша. Не сливайте непрочитанные diff ни с одного пути.

Если двоим нужно согласовать рефактор до выкладки, список файлов и рискованные куски — на одну страницу. Короткой комнаты oakmeet хватает: браузер, код пространства, без аккаунта. Пределы — в восемь человек, примерно час.

Agent — это то же, что Composer или Chat?

Текущая справка зовёт Agent помощником, который может править файлы и запускать команды. Старый интерфейс писал Composer. Если сборка всё ещё показывает Composer, выберите режим, которому можно править файлы, не только читающий Ask/Chat.

Нужны ли аккаунт и платная подписка?

Нужно войти. Расход Agent следует тарифу Cursor и лимитам модели. Актуальные тарифы — на cursor.com/docs. Эта страница тариф не продаёт.

Можно ли откатить принятый diff?

Restore Checkpoint на более раннем сообщении агента откатывает файлы после этой точки. git checkout / git restore по-прежнему покрывают уже лежащее на диске. Откат не стирает переписку.

Начинать ли с Plan?

Для большого изменения на много файлов таблица говорит: сначала Plan, утвердить подход, потом можно править. Для одной ясно ограниченной задачи в репо этот учебник идёт через Agent.

Начать