笔记 · Vibe Coding ·

每次开工先读交接单

Agent 每次开新会话都会失忆,所以要靠功能清单、进度记录和 git 提交来交接,一次只做一个功能,收工时留下干净的状态。

读书笔记原文:《Effective harnesses for long-running agents》↗Justin Young · Anthropic

为什么读

我建站是在一个很长的对话里完成的。如果项目更大,一个对话装不下,该怎么接着干?这篇正好讲这个。

我记下的要点

  1. 问题在于失忆。 模型一次能记住的内容(上下文窗口)有限,大项目要分好几次会话做,每次新会话都不记得之前干了什么。光靠自动压缩历史还不够。
  2. 两种典型翻车。 一是一次想做太多,做到一半上下文用完,留下半成品;二是后来的会话看到已有进度,就以为项目做完了。
  3. 第一次会话专门做准备。 一个“初始化 Agent”写好启动脚本、进度记录文件,做第一次 git 提交,并把需求拆成 200 多条功能清单,全部先标成“未通过”。
  4. 清单用 JSON 而不是 Markdown。 因为模型不太会乱改 JSON。后续会话只能改“是否通过”这一项,不许删改测试条目。
  5. 之后每次会话按固定顺序开工。 看目录、读 git 记录和进度文件、挑一个最重要的未完成功能,先启动应用跑一遍基本流程,确认之前没留下 bug,再开始做新的。
  6. 测试要像真人一样。 Claude 常常只跑了单元测试就宣布完成。给它浏览器自动化工具、要求按用户的方式操作后,效果好了很多。

我的想法

这套做法很像人和人之间的交接班:交接单、待办清单、每天收工前提交。说明 Agent 的问题,很多其实是项目管理问题,这让我这个产品人觉得亲切。

我在建站时让 Claude 做完一批改动就提交,当时只是觉得保险。现在明白了,提交记录本身也是写给下一次会话看的交接单,提交说明写清楚很重要。

还没想清楚的是:我的小项目要不要也弄一份功能清单?可能等功能多到我自己都记不住时再说。

我打算试试

  • 给网站项目建一个进度记录文件,每次收工让 Claude 更新几行
  • 下次开新对话时,先让它读这个文件和 git 记录再动手