补记说明:本文于 2026 年 10 月 25 日整理并首次发布。页面日期是这份经验的归档日期,历史案例与当前开放状态分别说明。

AI 助手(Agent)能帮我改代码、写文章。有时它做完一轮,只留下一句“已经完成”。过两天换个对话继续,我却还要重新问:完成的是哪一部分?有没有测?改动在哪里?现在能给别人用了吗?

这类问题问多了,我开始觉得,进度记录应该帮助下一次动手。下一位接手的人或 Agent,最好不用翻完所有聊天,就能找到继续的位置。

九月写过几十个 Agent 线程带来的中转问题。当时更关心目标该怎么留下来。现在我想把问题再往下放一层:每次停下来时,留什么,才能少讲一遍?

01 / 停下来前,留下五行
一份短交接,回答五个具体问题 交接依次说明目标、产物、验证、未决问题和下一步,让下次能找到动手的位置。 01 目标 这次希望得到什么 02 产物 文件或改动在哪里 03 验证 实际检查到了哪一步 04 未决问题 还没做什么,等谁判断 05 下一步 回来之后先做哪一下
交接卡示意。每行写一个具体答案,详细日志和版本链接另附;这张图本身不代表任何任务已经验收。

一句“完成”,装不下几种不同的结果#

以更新个人站为例。文章写好了、页面能显示了、变更通过检查了、内容已经发布了,分别都可以成为一个阶段的结果。但如果汇报里只剩“完成”,下一次就得重新核对。

我更愿意把结果写得窄一点:

记录接手时能确认什么
已完成文章草稿有文字可以审阅,发布仍是下一步
本地预览通过在这次预览环境里能正常阅读
检查通过这些检查覆盖的内容通过,范围需要能回查
线上回读通过发布后实际打开过对应页面,看到的是目标内容

这样写,别人不需要先猜“完成”指的是哪一种。发现缺口,也能直接回到缺的那一步。

02 / “完成”要说清是哪一步
写好、看过、检查过、上线看过各有含义 文章更新的不同阶段各提供不同结果,交接时用具体阶段代替一句笼统完成。 草稿写好 有内容可以审阅 本地预览通过 在本次环境里读过页面 相关检查通过 检查范围和版本能够回查 发布后线上回读 实际打开并核对目标内容
文章更新的阶段示例。卡片说明各自能证明什么;本地预览与检查通过都不能自动当作已发布。

结果和下一步,放在同一处#

进度列表里,我希望最快看见的是两件事:发生了什么变化,接下来动哪一下。

比如下面这条,是更新文章的示例记录:

结果:两篇草稿已完成,本地排版已检查;下一步:审阅正文,确定本轮发布范围。

它不需要把全部操作日志塞进列表。详细的文件位置、版本、预览和检查结果,可以放在关联材料里。列表告诉我该看哪里,材料负责让我查得下去。

如果只是写“继续优化”,我回来还是要先做一次规划。换成“检查手机宽度下的表格,再确定标题”,下一次就有了可以直接执行的起点。

留下依据,也留下没做的部分#

有些进度听起来很完整,真正接手时却没有落点:有截图,找不到对应版本;有测试结论,不知道测的是哪次改动;有本地文件,却以为已经在服务器上。

所以交接里,我会尽量把几样东西关联起来:当前需求、改动所在的位置和版本、实际做过的检查,以及尚未核对的部分。未提交的改动也要明确留下,不能只写一个提交号就假装覆盖了所有内容。

同样值得记录的,是这一轮没做什么。例如文章仍在本地、邀请链接还没开放、同步只核对了一端。这些事实会直接影响下一次该从哪里开始。

这也是我在整理 Agent 交付方法时一直想保留的关系:需求有来源,变更有版本,验收能找到依据。页面展示的是方法和目前的实践边界,完整的团队交付链还需要真实项目继续验证。

换个对话继续,先核对这五行#

交接材料也会过期。记下来的时候主线还没变,下一次打开时,也许已经合入了别的改动;当时还有效的入口,后来也可能暂停。

因此,“照交接继续”之前,还要核对当前文件、分支和相关结果。旧记录负责解释来路,当前现场决定现在从哪开始。

如果手边没有任何管理工具,我觉得一份短文档也能先解决问题。停下来前写五行:

  1. 这次要达到什么结果。
  2. 改动或产物在哪里。
  3. 实际验证到了哪一步,依据在哪里。
  4. 还有什么没做,或者等谁判断。
  5. 下次第一个具体动作是什么。

需要时再补上版本与链接。先让一次交接能用,再考虑把它接进更完整的系统。

我会让这五行尽量能独立阅读。下面是一份自编的文章更新示例,可以按自己的工作替换:

目标:把一篇产品经验整理成可公开阅读的图文。
产物:正文草稿和两幅解释图,均在本次工作区。
验证:标题与元数据已检查;手机排版尚未看完。
未决:产品当前入口还要回读,正文尚未发布。
下一步:先用手机宽度检查第二幅图,再核对公开入口。

这里没有塞进账号、内部地址或整段聊天。详细依据保留在合适的私有材料里,下一位有权限时可以继续核对。公开经验文章只展示模板与判断方法,不需要把整个执行现场一起公开。

回来以后,怎样避免又做一遍#

接手时我会先找到上一次留下的产物,看它是否仍然存在,再看当前版本有没有变化。已经做过的检查,如果覆盖的文件没变、前提仍成立,就保留结论;有新改动交汇时,再补相应验证。

比如上次写着“正文完成,等待公开入口”,回来发现入口已经开放,下一步就是回读并更新链接,不必从头重写文章。如果发现文章后来又改过,旧截图就只能说明旧版,不能直接贴到这次结果后面。

还要留意“待别人判断”和“自己还没动手”的区别。前者应当写清需要什么决定,后者应当留下可执行动作。都写成“待处理”,下一次就得再花时间辨认。

文章记录和工程交付可以使用同一套思路,但公开呈现的细节不同。我在个人 Agent和交付方法里展示方法,具体项目的授权、版本和未决事项仍要按各自事实核对。

我想减少的,就是换个对话后重新解释同一件事的次数。至于节省了多少时间,目前没有做对照统计。眼下更实际的检查是:下一次打开这份记录,我能不能直接开始做事。