第 2 课
写清需求与验收,用 Plan 模式审方案
把待办小全栈写成可检查的规格,用 Plan 模式让 Agent 提问并出方案,你改完方案再进入实现。
课程目录第 2 / 5 课
学习位置仅保存在当前浏览器,有效期 180 天。
规格与 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。
- 一份经过你删改的实现计划,没有额外框架和部署。
- 工作区文件除规格(和你主动保存的计划)外仍接近空白。
本课资料
适用环境
- 网页
- iOS
- macOS
- Windows
- Linux




