本文目录
  1. 把更新记录写进工作规矩
  2. 检查它会不会自己更新

最近在一个游戏站项目里,我开始试一个方法,让 AI 把项目进度写进文件,工作往前推进,记录也跟着更新。后面继续做的时候,先读记录,再接着往下干。

用 AI 做项目,一段对话可能持续很久,中间还会经历多次上下文压缩。前面讨论过的细节,后面继续做的时候,可能没有保留下来。换个新对话,也需要重新交代进度。如果需要换到另一个项目的会话里继续,也可以把这份交接记录带过去,方便它了解进度、核对相关文件。

哪些已经做了,哪些只是讨论过,哪个方案决定暂时不做,还有一些问题虽然改了,但没有验证。这些事情如果都留在聊天里,接着做的时候就得重新确认。

所以,我想给项目留一份交接记录,并且让 AI 自己维护,不用每次做完都提醒它记一下。

目前刚开始在游戏站里用,效果提升还要再观察。先把做法整理出来,用 Codex 做网站、工具的朋友可以找一个项目试试。

把更新记录写进工作规矩

这套方法先用两个文件就够了,都放在项目目录下。

一个叫 AGENTS.md,放工作规矩。开工先读哪里,什么时候更新进度,哪些事情需要我确认才能做,都写在这里。

另一个叫 STATE.md,放当前进度。现在做到哪一步,检查过什么,还有什么问题,下一步准备干什么。

两个都是文本文件,让 Codex 检查项目里现有的材料,再整理进去就行。已有状态文件就复用,不必为了文件名重新建一份。

这里有个前提,新对话需要能访问这些记录和相关项目文件。如果换了工作目录,也要先确认记录对应的是当前这份项目。只带过去一份旧记录,还需要核对实际文件和版本。

一定要把更新时间说清楚。完成一项任务、得到新的验证结果、遇到阻塞,或者准备结束这一轮工作,都应该更新。不能等到一个长任务结束,才想起来整理前面发生的事情。

打开正在做的项目,把下面这段发给 Codex。

请在当前项目里建立一个自动维护的交接机制。
目标是让你在推进工作时自己更新项目状态,
不依赖我每次提醒。新会话也能从记录接手。

先按需检查现有项目指令、计划、交接记录和相关文件,
确认工作目录、当前版本和未提交改动。
不要无差别扫描整个项目。
已有状态文件就复用,没有则创建 STATE.md。
记录更新时间、当前目标和工作范围、
已完成事项及证据、未完成或未验证事项、
阻塞、重要决定及原因,以及最多三项具体的下一步。
详细计划和报告只引用路径,不重复复制全文。
无法确认的内容写待确认,不要猜。
不得写入密码、密钥、令牌或不必要的个人信息。

在当前生效的项目指令中加入以下工作规则,
保留原有规则,遇到冲突先告诉我。
开工时,先读取状态入口,按需核实现状。
记录与实际情况不一致时,指出差异并核实,
不要直接把旧记录当成当前事实。

工作过程中,出现以下情况时主动更新状态文件,
不等用户提醒。
完成一项可验证的任务。
获得新的测试或检查结果。
确认一项重要决定或范围变化。
遇到阻塞,或者发现旧记录有误。
准备结束本轮工作或交还控制权。

更新应简短,只写发生变化的内容。
同一小阶段内的零碎操作可以合并记录,
不要每执行一条命令就重写整份文件。
区分代码已修改、本地已验证、已部署、线上已验证。
记录实际执行的检查及结果,没运行的注明未运行。
失败尝试写清方法、结果和仍未解决的问题。
结束前检查本轮重要变化是否已经写入文件。
如果写入失败,明确告诉我,不能声称记录已更新。
维护交接不代表获得新的开发、部署或发布权限。

本次只初始化交接机制。
不修改业务代码,不安装依赖,不部署,
不提交或推送,不修改全局配置,保留已有改动。
完成后告诉我修改了哪些文件、状态入口在哪里,
以及哪些信息仍需确认,然后停止。

这段发出去以后,先看它整理的内容有没有问题。

尤其要检查记为“完成”的事项。代码改过、本地测试通过、已经部署、线上确认生效,是几件不同的事,不能全部记成一句“已完成”。

检查它会不会自己更新

文件建好以后,接着正常做一项小任务。这次不用提醒它更新记录。

做完看看 STATE.md,有没有记下本次修改、实际验证结果和下一步。只在聊天里说“已完成”,文件没变化,说明自动更新的约定还没有执行到位。

然后在同一个项目、同一份工作目录里新开一个对话,不贴旧聊天记录,发送下面这段验证一下效果。

请读取当前项目指令和指定的交接记录,
按需核对项目文件、当前版本和已有验证结果。
这次只检查,不修改文件,不执行开发或部署。
告诉我当前在做什么,
上一阶段完成了什么,证据在哪里,
哪些仍未验证或被阻塞,
下一步具体做什么,以及有哪些边界需要遵守。
发现记录过时、缺失或互相矛盾,请指出。
不要自行补全,也不要重新制定总体计划。

对照刚才完成的任务,看它接得对不对。

我准备在游戏站里继续观察实际使用效果,后续再来一次效果复盘。到时候具体看它接对了什么、漏了什么,以及有没有按约定更新记录。有试用反馈,也欢迎到本文对应的公众号原文下交流。

· · ·

感谢阅读,我们下一篇见。

在公众号阅读原文 ↗
← 所有文章

再读一篇

我给 Steal An Egg 做了个攻略站,第一版只发了 7 篇 ↗我给自己的网站找流量,发现了另一门生意 ↗