别把 Cursor Agent 当聊天框

别把 Agent 当聊天框:第一次成功是一条已审过的 diff,不是一段说明。

把 Cursor Agent 当聊天框,第一次运行就会停在一段解释上,仓库里什么都没动。侧栏用 Cmd+I(Windows / Linux:Ctrl+I),给一个能落盘的结果,再审 diff。要先把目标摊开,去 wbstorm 开房间。

官方 Quickstart 写的第一次有用结果是 一次小的、已审过的改动,不是一段「这个仓库大概在干什么」。装好、登录、打开文件夹,再开 Agent。

打开文件夹Cmd+I 开 Agent一小步 · 审 diff

聊天框思维会卡在哪

01

只要解释

「讲讲这个仓库」会搜文件、读入口,但目录树没变。那是热身,不是第一次成功。

02

不写结果

「帮我看看」没有可核对的完成条件。官方示例是列出三个低风险改动,等你选一个再动手。

03

不看 diff

Agent 会改文件、跑终端。第一次成功以 diff 和你项目里已有的检查为准,不以回复长度为准。

第一次真正跑通

  1. 1

    打开仓库

    从 cursor.com 安装并登录。macOS 12+、Windows 10+;Linux 官方给 apt / dnf / AppImage。打开你要改的那个文件夹,不要对着空窗口聊天。

  2. 2

    打开 Agent 侧栏

    快捷键 Cmd+I / Ctrl+I。官方定义:Agent 能独立完成复杂编码任务、跑终端、改代码。工具调用次数在一次任务里没有上限。

  3. 3

    要一个能落盘的结果

    直接描述改完长什么样。或按 Quickstart:先让它建议三个安全的小改动,你选一个。文案、小 UI 问题适合当第一刀。

  4. 4

    审 diff,再跑已有检查

    看 diff。让它跑你们仓库已经在用的测试、类型检查、lint 或本地构建。回滚用时间线上的 checkpoint;checkpoint 只还原文件,不删消息,也不能代替 Git。

你在做什么像聊天框像 Agent
第一句「这是什么项目?」「改 X,完成标准是 Y」
成功标准一段摘要已审 diff + 已有检查
模式只读问答Agent 工具;大改走 Plan

给它看的第一句

Suggest three small, safe improvements in this codebase.
Explain the tradeoffs and wait for me to choose one.

选中之后补一句结果,不要再扩写成闲聊。Agent 工作时 Enter 会把下一条指令排队;Cmd+Enter 立刻插入当前轮。反复同一约束,再写成 Cursor Rules 的 .mdc。

草图和投票不在编辑器里:用 房间号 和 白板基础 即可。本页不讲 wbstorm 如何改代码。

Cmd+I 打不开?

对照 cursor.com/docs/reference/keyboard-shortcuts:Cmd+I 切换侧栏。也可在命令面板搜 Agent。先打开一个文件夹,空窗口没有仓库可改。

只想问、不想改文件?

那不是第一次 Agent 成功。CLI 文档把 Ask 写成只读探索。编辑器里大改用 Plan Mode(Shift+Tab),避免一上来就改一堆文件。

checkpoint 能代替 Git 吗?

不能。官方写 checkpoint 存在本机、和 Git 分开,只用来撤销 Agent 改动。长期历史仍提交到 Git。

第一次该改多大?

Quickstart 建议低风险:文案或小 UI。跨多文件、需求不清时先 Plan,再点构建。

创建房间