循环记忆
反思式(Reflexion-style)言语记忆:代理以书面形式反思每次尝试, 存储该反思,并在行动前读取最近的反思。研究 (Shinn 等人,2023)表明,这种机制——反思、存储、重读—— 在广泛范围内优于盲目重试(在12轮决策任务上提升22%, 在代码任务上提升11%),并且优于无反思的记忆8个百分点。 其收益来自书面原因,而不是来自更努力地重试。
协议
行动前(每次任务)
- 读取
.loop/LESSONS.md。 - 无条件应用通用规则部分。
- 读取最近3条记录。如果任何一条与当前任务相关, 用一行说明它将如何改变你的方法。如果均不相关, 则继续——不要强行关联。
行动后(每次尝试,无论成败)
按文件的格式追加恰好一条条目:
## [日期] — [任务,最多5个词] — 成功|失败
- 发生了什么:[一行]
- 根因/为何成功:[一行]
- 下次:[一条具体的、可检查的指令]
“下次”的质量标准:
- ❌ “对数据库要更小心” — 不可检查
- ✅ “在任何种子脚本之前运行
npx prisma migrate deploy” — 可检查 - ❌ “记住API很棘手” — 模糊
- ✅ “
/users端点每页返回50条;计数时始终传递 `?page=”
失败反思,具体来说
当一次尝试失败时,反思必须回答:我相信了什么? 而那是错误的。失败的尝试通常源于一个错误的假设,而不是一个拼写错误。 指出那个假设。那才是教训。
维护(当文件超过约30条时)
- 按从旧到新的顺序读取所有条目。
- 任何出现2次或以上的教训被升级到通用规则中, 重写为一条祈使句。
- 升级后删除最旧的20条条目。
- 未经用户批准,绝不删除通用规则。
不应存储的内容
- 密钥、令牌、个人数据——绝对不要,即使它们导致了失败。
- 叙述(“然后我尝试了X,之后Y……”)——只存储结论。
- 重复教训——如果已经存在,不要再次添加;考虑将其升级。
- 责备或自我批评——教训是指令,不是情绪。
需避免的失败模式
- 记忆表演: 写入条目但从不读取。读取步骤 是价值所在;仅写入步骤只是写日记。
- 过度拟合单次事件: 一次性的环境故障不是 教训。如果它不会重复发生,就不要记录。
- 无限制增长: 一个200条且无人阅读的文件是死记忆。压缩它。