用途
Agent Memory 用于把 AI 在项目中的重要上下文从聊天窗口转移到仓库文件中，使决策、偏好和产品状态可被持久保存、检索和版本管理。
主要能力
记忆默认存放在 docs/agent-memory/ 目录，分为三类文件：
- decisions.md：记录决策及其原因，格式包含日期与摘要。
- preferences.md：记录用户或项目的偏好，例如技术栈、语气、UI 风格。
- context.md：记录产品当前摘要与状态。
首次写入记忆时若目录不存在，需创建该目录。
使用方式
在开始长时间或含糊任务前，先读取已有记忆文件，使用其中记录的信息，并注明来源（例如“在 preferences.md 中……”）。在出现相关决策、新偏好或产品上下文变化后更新对应文件。若文件中没有某项记忆，不应臆造，应询问用户或将其登记为新条目。
决策条目采用固定格式：
YYYY-MM-DD — <标题>
- 决策： ……
- 为什么： ……
- 后果： ……
适用场景
适合需要跨会话保持项目一致性的开发工作，例如长期任务、多人协作项目、需要遵循既有技术栈与界面偏好的场景。
限制
记忆属于项目并随 Git 版本化。不得写入令牌、密钥、密码等机密信息。条目应简短且可检索，避免保存整段对话内容。