垦荒学园
  • 中文

      • Agent 工作台

      Agent 是 Cursor 的主助手：能独立完成较复杂的编程任务、跑终端命令、改代码。在侧栏打开：macOS Cmd+I，Windows / Linux Ctrl+I。权威说明见 Agent Overview。

      三个组件

      组件内容
      Instructions系统提示 + 规则（项目 / 用户 / 团队 / AGENTS.md）
      Tools搜仓库与网页、读改文件、跑命令、浏览器、生图、提问等
      Model你为这次任务选的模型（见 模型选择）

      Cursor 会按模型调教指令与工具。你的工作是：把目标写清楚、把规则检入 Git、在 diff 上把关。单次任务里的工具调用次数没有官方上限。

      工具清单（官方分类）

      工具做什么
      Search files and folders按文件名、目录结构、关键字 / 模式搜索
      Web生成查询并检索网页
      Fetch Rules按类型与描述取回规则
      Read files读源码；也支持图片（.png / .jpg / .gif / .webp / .svg），供带视觉能力的模型分析
      Edit files提出并自动应用编辑
      Run shell commands执行命令并看输出；默认用第一个终端 profile
      Browser截图、点页面、核视觉变化（详见官方 Browser 文档）
      Image generation按文字或参考图生成；默认存到项目 assets/，并在聊天里内联展示
      Ask questions任务中途澄清；等你回答时仍可继续读文件 / 编辑 / 跑命令

      指定默认终端：Ctrl+Shift+P（macOS Cmd+Shift+P）→ Terminal: Select Default Profile。

      MCP 工具会出现在 Available Tools 里，Plan Mode 也会用。见 MCP 集成。

      检查点（Checkpoints）

      Agent 在做较大改动前会自动拍快照，覆盖将要改的文件。

      • 在聊天时间线点某个检查点，可预览当时的文件，再 Restore。
      • 也可在上一条请求上点 Restore Checkpoint，或把鼠标移到消息上用 +。
      • 恢复只回滚文件，不会删聊天记录。
      • 检查点存在本地，与 Git 分开。用它撤 Agent 的探索；用 Git 做持久版本。
      If this refactor looks worse than the last checkpoint, restore that
checkpoint. Keep the conversation. Then try a narrower approach:
only extract the parser, do not touch the CLI.

      检查点适合探索、大重构、迭代试错。不要把它当成分支策略。

      队列与立即发送

      Agent 还在跑时，你有两种说话方式：

      操作快捷键行为
      入队Enter等当前任务结束后按顺序执行；条目可拖拽重排
      立即发送Cmd+Enter / Ctrl+Enter绕过队列，接到最近一条用户消息上，马上处理

      立即发送适合纠偏（「停下，别改 schema」）。入队适合「做完测试再写 changelog」。

      官方还有 steer：跟进会在下一次工具调用边界送达，而不是砍到一半。Web / Agents Window 的按键可能不同（有的版本用 Tab 入队）；桌面侧栏先记 Enter 入队、Ctrl/Cmd+Enter 立即发送。CLI 里：工作中按 Enter 会在安全边界转向，再按一次中断该轮。

      /goal：长目标

      Agent 默认把每条消息当成新任务。/goal 用来挂一个做到完成为止的目标：

      /goal fix all flaky tests and make CI green
      • CLI 里 Ctrl+C 会暂停 goal。
      • 可搭配 Custom Mode（整段会话遵循同一 playbook），或内置 /loop 做周期性检查。
      • 官方写明 /goal 仍在逐步放开；若当前聊天没有，新开一个会话再试。

      /goal 适合「测到绿」「把这一层的 lint 清掉」这类有完成定义的目标，不适合没有验收标准的「把架构变好」。

      一次任务怎么写

      把范围、禁区和验证写进同一条：

      Add request IDs to HTTP error logs in the existing logger.

Constraints:
- Do not change public API shapes
- Do not add dependencies

Verify:
- Run the repo's unit tests
- Show one before/after log line

      然后：看 diff → 看它跑了哪些命令 → 必要时 Restore。

      安全习惯

      • 批准终端命令前先读命令行；破坏性 git / 生产凭据操作要拦下来。
      • MCP 与终端服从同一套 Run Modes；收紧自动批准，直到你信任这条工作流。
      • 检查点不是备份策略；重要节点请 git commit。

      下一步

      评论