项目记忆系统

要解决什么问题

长期在一个仓库里和 Agent 协作时，上下文窗口会被「昨天聊了什么」「这个项目现在卡在哪」反复挤占。如果把所有细节都塞进对话或单一大文件，要么加载太慢，要么第二天续聊时丢状态。你需要的是只跟项目/主题相关、可渐进加载、又能跨会话回写的本地记忆，而不是人格画像或用户档案。

技能如何工作

project-memory-system 用固定目录约定把记忆拆成三层：

• memory/YYYY-MM-DD.md：当天各项目的简短摘要，避免前一日日记整包进上下文。
• memory/topics/index.md：全局索引，只做导航、命中与状态总览，不写单项目长文。
• 每个 topic 目录下：00-overview.md 承载全景与当前状态；journal/YYYY-MM.md 记当月推进细节；01/02/03... 按项目类型自由扩展。

初始化时读取 references/initialization-flow.md，执行 scripts/init_project_memory.py --workspace，并按 references/agents-integration.md 把最小常驻规则写入工作区 AGENTS.md。脚本会扫描已有 topic、区分是否已结构化、标出旧结构或异常项；不会因为 daily 里提到某项目就自动新建 topic，也不会在初始化阶段擅自重构旧目录。

日常推进时先命中 index.md → 00-overview.md，仅在任务需要时再读扩展文件与当月 journal。出现子任务完成、稳定结论、关键卡点、明确下一步或阶段收尾等节点时，按 references/writeback-rules.md 回写：日摘要写短、journal 写细、00-overview 与编号文件只在全局状态变化时更新。

适用边界与注意点

• 只负责项目记忆 / topic 记忆；不初始化人格、身份或用户画像。
• 新建主题 / 项目档案必须在用户明确要求后才做。
• 旧 topic 若结构不完整，初始化阶段先沿用并汇报，整理需等用户明确指令。
• 每个项目不再使用单独的 memory/topics/<name>.md 入口，与 00-overview.md 职责分离，避免重复维护。