city-life-line/docs/superpowers/specs/2026-08-14-project-memory-design.md

项目记忆库设计

目标

在仓库内建立可持续维护的项目记忆库，保存每次对话的上下文、技术决策、变更记录和待办事项，并定期将稳定信息整理为长期记忆。

目录结构

AGENTS.md
memory/
├── README.md
├── index.md
├── long-term.md
└── sessions/
    └── YYYY-MM-DD.md

文件职责

• AGENTS.md：项目级协作规则。每次任务开始先读取 memory/index.md 与 memory/long-term.md；任务结束更新当日会话记录。
• memory/README.md：记忆库使用说明、记录模板、整理周期和隐私边界。
• memory/index.md：当前项目状态、关键入口和会话记录索引。
• memory/long-term.md：稳定有效的架构事实、用户偏好、已确认决策和长期约定。
• memory/sessions/YYYY-MM-DD.md：按日期聚合的会话记录，记录目标、结论、修改文件、验证结果、风险和后续行动。

更新规则

1. 每次对话结束时，追加或更新当天的会话文件。
2. 只记录可复用的项目上下文，不记录密码、Token、地图密钥或其他敏感值。
3. 用户明确确认的决策进入 long-term.md；临时猜测只放在当日会话文件。
4. 每累计 5 次会话，或当日会话文件超过约 20 KB，整理一次长期记忆并更新索引。
5. 过期内容不直接删除，改为标记为“已废弃”或移动到 memory/archive/（如确有需要）。

兼容性

该方案只增加 Markdown 文档和目录，不参与 Vite 构建，不改变运行时行为，不增加 npm 依赖。

验收标准

• 新会话可以通过 AGENTS.md 找到记忆库入口。
• 记忆库包含规则、索引、长期记忆和至少一个会话记录模板。
• 记录中不出现敏感配置值。
• 不影响现有 npm run dev、npm run build:prod 等项目脚本。