本目录只记录 RAG Evolution Playbook 已经实际完成的工作、偏差和验证结果。计划中的动作、尚未执行的意图和聊天中的完成声明不属于执行证据;它们应留在路线图、实施计划或后续行动中。
- 记录已经落盘的文件变更、实际运行的检查、明确观察到的结果和对应 commit。
- 记录实施偏差时同时说明原因、影响和处理决定,不用执行记录重新定义需求。
- 每个阶段出口至少有一条执行记录;文件名使用
YYYY-MM-DD-short-topic.md,主题部分使用 ASCII 小写短语。
- 日期:使用
YYYY-MM-DD,表示变更和验证实际发生的日期。 - 阶段:使用路线图中的 Foundation、Research、Baseline、Scheme A、Scheme B、Composition、Handoff 或 Skill Incubation。
- 来源/变更:关联批准的计划、决策或需求,并列出本次实际修改的文件和范围。
- 证据:记录实际运行的命令、关键输出、Git commit 或可定位文件;聊天内容和预期结果不能代替命令与仓库状态。
- 结论:只陈述已完成、部分完成或未通过的实际结果,不推测尚未执行的结果。
- 影响:说明本次变更对阶段出口、依赖、契约或后续工作造成的实际影响。
- 下一步:写尚需执行的具体动作或允许推进的阶段;若无后续动作,说明该记录为何可以关闭。
执行记录不是工作清单。只有文件变更可定位、验证结果可重现且实际状态与结论一致时,才能写为完成;审阅意见和验收结论应进入 project/reviews/。