2

写清需求与验收,用 Plan 模式审方案

把待办小全栈写成可检查的规格,用 Plan 模式让 Agent 提问并出方案,你改完方案再进入实现。

图文12 分钟Cursor 官方文档 ↗

课程目录2 / 5

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

01 / 图文教材

规格与 Plan 模式

官方 Plan 模式会先问澄清问题、检索仓库、写出可编辑方案,等你点同意再构建。多文件、多种实现都说得通时,先走 Plan。对照:Plan Mode · Agent mode 说明

在仓库里写下规格,而不是只存在聊天里

在项目根目录新建 SPEC.md(用手写即可)。必须写清:单一 Node.js 进程;只用标准库模块 http、fs、path、url,不要引入第三方包;数据文件为根目录 todos.json(JSON 数组);GET / 返回 HTML 页面;GET /api/todos 返回全部待办;POST /api/todos 用 JSON 传入 title 字段,去空白后不能为空;PATCH /api/todos/:id 用 JSON 传入 done 布尔值;监听 127.0.0.1 的 3456 端口且只绑回环;README.md 写明用 node 启动入口文件;不创建部署配置、容器文件、云函数或环境变量文件。

验收写进同一文件:浏览器打开该本机地址能看到列表;新增后刷新仍在;勾选后 done 为真。

用 Git 记下规格

把 SPEC.md 加入暂存并查看 git status。实现开始前先有一个干净对照点。可以做一次只含规格的提交;不提交也可以,但后面必须能看 diff。

打开新对话并切到 Plan

新开 Agent 对话(不要接着第 1 课的 Ask)。用 Shift+Tab 或模式下拉选 Plan。官方写:Cursor 也会在你的措辞像复杂任务时建议 Plan。

把规格交给 Plan,要求它先提问

发送:阅读根目录 SPEC.md;不要改任何文件;先问最多 5 个会改变实现的澄清问题,然后给出分步实现计划(要新建哪些文件、每个文件职责、如何验收三个 API);若规格有冲突,停下来指出,不要自行放宽约束。

回答问题时保持范围小:不要同意加用户系统、数据库或公网部署。

审方案并改进工作区

Plan 会生成可编辑方案。核对:是否仍是标准库、是否仍绑回环地址 3456、是否出现你没要的框架。官方允许把方案保存到工作区;若界面提供保存到工作区,保存后你能在仓库里再改一版。把任何「顺便加上构建链、前端框架或数据库」删掉。

明确暂不构建

本课不要点构建、不要切回 Agent 让它写代码。你应能向同事复述:入口文件是什么、数据怎么存、怎样用浏览器和命令行证明它活着。

失败与安全

  • Plan 直接改文件:Stop,确认模式标签仍是 Plan;必要时 Restore Checkpoint。
  • 方案把端口改成公网监听:改回规格,不要「为了方便」放开。
  • 官方建议方案不对时回退再收紧计划,而不是在错误实现上打补丁。

你做完应该看到

  • 仓库里有一份你自己能执行的 SPEC.md。
  • 一份经过你删改的实现计划,没有额外框架和部署。
  • 工作区文件除规格(和你主动保存的计划)外仍接近空白。