用途:history-hygiene 关注历史记录文件(如记录决策、spawn、结果的 .md 文件)的卫生问题。这类文件会被未来的智能体冷读,过时或错误的条目会污染下游决策。资料提到 Kobayashi 事件:历史记录写的是“Brady decided v0.6.0”,而 Brady 实际已改为 v0.8.17,后续 spawn 读到错误事实并重复了错误。
主要能力与原则:记录最终结果,而不是最初的请求;在写入历史前等待确认,不记录中间状态;若决定被推翻,立即更新条目,不留下过时数据;一次读取等于一个真相,未来智能体不应需要交叉引用其他文件才能理解实际发生了什么。
正确示例:Migration target: v0.8.17 (initially discussed as v0.6.0, corrected by Brady);Reverted to Node 18 per Brady's explicit request on 2024-01-15。错误示例:Brady directed v0.6.0(后来被推翻时);记录被请求的内容而非实际发生的事;在结果确认前就写入条目。
反模式:把中间或“暂时”状态写入磁盘;在未确认最终方向时归因决策;把历史当作草稿——历史是事实来源;假设读者会交叉引用或核实,而他们不会。
使用方式与限制:资料未提供具体安装命令、配置方式或平台支持信息,暂未提供。