3

用 Agent 跨文件实现,并用检查点回退

在 Agent 模式按已审计划改多文件,观察 diff 与终端命令,练习 Restore Checkpoint,并理解检查点不是 Git。

图文15 分钟Cursor 官方文档 ↗

课程目录3 / 5

学习位置仅保存在当前浏览器,有效期 180 天。

01 / 图文教材

Agent 实现与检查点

Agent 可检索代码、编辑文件、执行终端命令。开始大幅修改前会自动建检查点。对照:Agent overview · 如何开始 / 如何撤销

新对话切到 Agent,引用计划和规格

新开对话,模式选 Agent。不要把第 2 课 Plan 对话硬切过来(官方:换模式会换上下文)。提示要求:严格按照 SPEC.md 和仓库里的实现计划编写;一次做完最小可运行版本(入口文件、必要页面、README);改文件前不要安装任何包;每创建一个文件后用一两句话说明它做什么;只绑回环 3456;不要添加部署文件。

看着 diff 生长,必要时 Stop

官方 Quickstart:diff 视图会显示 Agent 正在改什么。若它开始加入第三方框架、依赖清单、容器文件,或把监听改成所有网卡,点 Stop,发一条更硬的约束再继续。不必等它跑完再后悔。

允许只读检查,拒绝多余命令

Agent 默认会跑终端。允许查看 Node 版本、列出文件这类检查。拒绝:全局安装包、修改 git 配置、把仓库推到远程、读取 SSH 目录或系统密钥。命令看不懂就拒绝,改用 Ask 解释这条命令。

主动做一次检查点回退练习

等它至少改了两个文件后,在时间线上点某个检查点预览,再使用 Restore Checkpoint(官方:悬停旧消息,或时间线预览后还原)。还原只恢复文件,对话还在。还原后再说:「按 SPEC.md 重来,不要加依赖。」体会会话安全网和 Git 的差别。

让它把最小版本做完,但不要现在测功能

恢复后让 Agent 做到:存在入口文件与 README,规格里的三个 HTTP 行为都有对应代码。本课不强制浏览器点通——那是第 4 课。你现在只要求文件齐、无明显规格背叛。

排队跟进,不要同时开多个互相打架的任务

官方支持在 Agent 工作时把下一条指令排队。本练习保持一条主任务。不要同时再开一个「顺便加暗色主题」的并行目标。

失败与安全

  • 改动面过大:Restore 到实现前,收紧提示后重跑;官方认为这比在脏 diff 上修补更快。
  • 检查点找不到:确认仍在同一次 Agent 会话;检查点是本地、会话级的。
  • 不要在练习里打开自动批准所有终端一类宽松设置(若你的版本提供类似开关)。

你做完应该看到

  • 至少演练过一次 Restore Checkpoint,并知道它不删聊天。
  • 工作区有按规格约束的入口文件和 README。
  • git diff 能列出 Agent 改过的文件,且没有密钥文件和依赖锁文件战争。