审 diff、本地跑通，失败再让 Agent 修

先读完整 diff，再运行

在源代码管理或 diff 视图通读改动。拒绝规格外的内容：跟踪脚本、远程地址、把待办同步到第三方、读取环境变量里的密钥。有问题先 Restore 或让 Agent 删掉多余文件，不要带着未知代码启动。

按 README 启动，只绑本机

在 Cursor 终端运行 README 中的启动命令。日志里应看到监听 127.0.0.1 的 3456 端口。若报端口占用，换端口前必须同步改规格和代码，不要改成监听所有网卡。

用本机 HTTP 请求打三个接口

对 http://127.0.0.1:3456/api/todos 发 GET，应返回 JSON 数组。再 POST 一条带 title 的待办，然后再次 GET，应能看到新条目，且 todos.json 已写入。再用 PATCH 把该 id 的 done 改为真。title 为空的 POST 应返回 4xx，而不是写入空白待办。可用编辑器、浏览器或你熟悉的 HTTP 客户端，不必绑定某一条命令行工具。

浏览器点一遍页面

打开 http://127.0.0.1:3456 。列出、新增、勾选。刷新页面后数据还在。这才算「跑起来」，不是生成了文件就算。

故意制造一次失败，让 Agent 只修这一处

若前面已失败：把完整终端报错贴回同一 Agent 对话，写清「只修导致该错误的最小改动」。若前面全绿：临时把 todos.json 改成非法 JSON 后重启，确认进程有明确错误而不是挂死；再让 Agent 加上启动时的 JSON 解析失败处理。一次只交一个故障。

可选：对当前改动跑 Agent Review

在 Agent 输入框使用官方斜杠命令 /agent-review，或在源代码管理里对相对主分支的本地改动跑 Agent Review。入门用 Quick 深度即可。Deep 更慢更贵，留给复杂逻辑。自动「每次提交都审查」先保持关闭，避免半成品 diff 刷出噪声。设置项位置以你当前版本文档为准（官方提到过从 Agents 迁到 Git 与 PR 相关i��）。

失败与安全

• 端口占用：查谁占用 3456，不要改听所有网卡。
• 页面空白但 API 正常：让 Agent 只查 GET / 的静态响应，不要借机引入前端框架。
• Agent 把测试失败理解成「重写架构」：Stop，Restore，提示改为「保持 SPEC，只修报错」。

你做完应该看到

• 本机浏览器能完成新增和勾选，刷新后仍在。
• GET / POST / PATCH 的结果与 todos.json 一致。
• 朊一次「报错到最小修复再到测」的记录，而不是从零重生仓库。