每次开工先读交接单
Agent 每次开新会话都会失忆,所以要靠功能清单、进度记录和 git 提交来交接,一次只做一个功能,收工时留下干净的状态。
读书笔记原文:《Effective harnesses for long-running agents》↗Justin Young · Anthropic
为什么读
我建站是在一个很长的对话里完成的。如果项目更大,一个对话装不下,该怎么接着干?这篇正好讲这个。
我记下的要点
- 问题在于失忆。 模型一次能记住的内容(上下文窗口)有限,大项目要分好几次会话做,每次新会话都不记得之前干了什么。光靠自动压缩历史还不够。
- 两种典型翻车。 一是一次想做太多,做到一半上下文用完,留下半成品;二是后来的会话看到已有进度,就以为项目做完了。
- 第一次会话专门做准备。 一个“初始化 Agent”写好启动脚本、进度记录文件,做第一次 git 提交,并把需求拆成 200 多条功能清单,全部先标成“未通过”。
- 清单用 JSON 而不是 Markdown。 因为模型不太会乱改 JSON。后续会话只能改“是否通过”这一项,不许删改测试条目。
- 之后每次会话按固定顺序开工。 看目录、读 git 记录和进度文件、挑一个最重要的未完成功能,先启动应用跑一遍基本流程,确认之前没留下 bug,再开始做新的。
- 测试要像真人一样。 Claude 常常只跑了单元测试就宣布完成。给它浏览器自动化工具、要求按用户的方式操作后,效果好了很多。
我的想法
这套做法很像人和人之间的交接班:交接单、待办清单、每天收工前提交。说明 Agent 的问题,很多其实是项目管理问题,这让我这个产品人觉得亲切。
我在建站时让 Claude 做完一批改动就提交,当时只是觉得保险。现在明白了,提交记录本身也是写给下一次会话看的交接单,提交说明写清楚很重要。
还没想清楚的是:我的小项目要不要也弄一份功能清单?可能等功能多到我自己都记不住时再说。
我打算试试
- 给网站项目建一个进度记录文件,每次收工让 Claude 更新几行
- 下次开新对话时,先让它读这个文件和 git 记录再动手