别把 Cursor Agent 当聊天框
别把 Agent 当聊天框:第一次成功是一条已审过的 diff,不是一段说明。
把 Cursor Agent 当聊天框,第一次运行就会停在一段解释上,仓库里什么都没动。侧栏用 Cmd+I(Windows / Linux:Ctrl+I),给一个能落盘的结果,再审 diff。要先把目标摊开,去 wbstorm 开房间。
官方 Quickstart 写的第一次有用结果是 一次小的、已审过的改动,不是一段「这个仓库大概在干什么」。装好、登录、打开文件夹,再开 Agent。
聊天框思维会卡在哪
只要解释
「讲讲这个仓库」会搜文件、读入口,但目录树没变。那是热身,不是第一次成功。
不写结果
「帮我看看」没有可核对的完成条件。官方示例是列出三个低风险改动,等你选一个再动手。
不看 diff
Agent 会改文件、跑终端。第一次成功以 diff 和你项目里已有的检查为准,不以回复长度为准。
第一次真正跑通
- 1
打开仓库
从 cursor.com 安装并登录。macOS 12+、Windows 10+;Linux 官方给 apt / dnf / AppImage。打开你要改的那个文件夹,不要对着空窗口聊天。
- 2
打开 Agent 侧栏
快捷键 Cmd+I / Ctrl+I。官方定义:Agent 能独立完成复杂编码任务、跑终端、改代码。工具调用次数在一次任务里没有上限。
- 3
要一个能落盘的结果
直接描述改完长什么样。或按 Quickstart:先让它建议三个安全的小改动,你选一个。文案、小 UI 问题适合当第一刀。
- 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,再点构建。