用途:把 tasks/memory.md 维护成项目“什么最重要”的长期记录,写给接手项目的人或日后回来的自己,说明当前进展、已定决策和继续前行动前需注意的事项。
主要能力:记录项目概要(是什么、面向谁、成功指标)、当前状态(已完成、下一步、阻塞)、关键决策(选择、原因、权衡)、已完成工作(功能 ID、prd、结果)以及注意事项(约束、陷阱、约定、易错点)。
使用方式:确保 tasks/ 存在,缺失时创建 tasks/memory.md;就地更新,不重写整个文件;在相关章节添加 1–3 行短条目;相关时引用功能 ID(f-##)和 prd 路径;不清楚记录什么时先问一个澄清问题。模板包含 Project、Current state、Key decisions、Completed、Notes / gotchas、Links 等章节。
适用场景:01-new 阶段项目定义变化或重大规划决策时;02-prd 阶段 prd 引入关键决策、约束或跨领域行为时;03-exe 阶段发现重要陷阱或敲定重大实现决策时,以及在 prd 中勾选 Implemented 或 Merged 后更新 Current state 和 Completed。
限制:不存储密钥(API key、token、凭据);条目保持简短持久,避免重复冗长 prd 或代码;不记录原始会议记录、逐日流水账或 prd/代码中已有的重复内容;输出为创建或更新 tasks/memory.md,并回复文件路径和简短更新摘要。