项目记忆系统

这个 skill 用一套本地文件结构维护项目记忆：

• memory/YYYY-MM-DD.md 记录当天的简短项目摘要
• memory/topics/index.md 记录全部项目记忆索引，只做导航、命中与状态总览
• memory/topics//00-overview.md 记录单个项目的全景、当前状态与导航
• memory/topics//journal/YYYY-MM.md 记录详细推进过程

它只负责项目记忆 / topic 记忆，不负责人格、身份或用户画像初始化。

核心规则

• 只有用户明确要求“新建主题 / 新建项目档案”时，才允许创建新的 topic。
• 初始化时只补齐项目记忆骨架，不因为 daily memory 里提到某个项目就自动建 topic。
• 初始化完成后，要把最小必要的项目记忆规则写入工作区 AGENTS.md，让这套机制成为常驻行为，而不只是一次性 skill。
• memory/topics/index.md 只做全局索引，不承载单个项目的详细背景、结论或下一步。
• 每个项目只保留目录结构，不再使用 memory/topics/.md 这种项目入口文件，避免和 00-overview.md 职责重叠。
• 结构化 topic 目录里，00-overview.md 是唯一必需文件；01/02/03... 文件按项目类型自由扩展。
• 初始化时不要擅自重构旧 topic；只识别、分类、汇报，等用户明确要求后再整理。
• memory/YYYY-MM-DD.md 只记录简短项目摘要，避免前一日日记自动加载时占用过多上下文。
• memory/topics//journal/YYYY-MM.md 记录详细项目推进过程，供后续按项目命中后渐进加载。
• 00-overview.md 与 01/02/03... 只维护长期有效的项目状态与结构化认知，不写流水账。

初始化流程

当用户要求初始化、修复、接管项目记忆时：

1. 读取 references/initialization-flow.md。
2. 运行 scripts/init_project_memory.py --workspace <目标工作区>。
3. 按 references/agents-integration.md 中的规则检查并更新工作区 AGENTS.md，把最小常驻项目记忆规则写进去。
4. 查看脚本输出的初始化结果与中文摘要。
5. 向用户汇报：
• 新补齐了哪些基础文件；
• 扫描到了多少个 topic；
• 哪些 topic 已结构化；
• 哪些 topic 还待结构化；
• 哪些 topic 存在旧结构或异常项；
• AGENTS.md 是否已补齐项目记忆常驻规则；
• 后续将继续遵守“只有用户明确要求时才新建 topic”的规则。
6. 如果发现旧 topic 结构不完整，先继续沿用，不要在初始化阶段直接改结构；把它们作为后续可整理对象说明给用户。

日常维护流程

当用户正在推进一个已有项目，或当前协作形成了一个稳定阶段结果时：

1. 读取 references/writeback-rules.md。
2. 命中已有 topic 时，先读 memory/topics/index.md，再进入对应项目目录读取 00-overview.md。
3. 只在当前任务确实需要时，按需读取 01/02/03... 文件与当月 journal。
4. 当出现以下任一情况时，执行一次项目记忆回写：
• 完成了一个明确子任务；
• 形成了稳定结论；
• 发现或解决了关键卡点；
• 明确了下一步；
• 当前项目/主题已经做了实质推进，但对话被切到别的话题，当前项目收尾了。
5. 回写时遵守三层规则：
• memory/YYYY-MM-DD.md：写简短摘要；
• journal/YYYY-MM.md：写详细过程；
• 00-overview.md / 01/02/03...：仅在项目全局状态改变时更新。
6. 如果旧 topic 结构不理想，先继续当前任务，再轻量提醒后续可整理；不要因为结构问题中断当前协作。

使用已有 topic

当任务命中已有 topic 时：

1. 先读全局索引：memory/topics/index.md。
2. 命中项目后，进入对应目录读取 00-overview.md。
3. 只在当前任务确实需要时，按需读取 01/02/03... 文件。
4. 只有在最近推进历史会影响当前判断时，才读取当月 journal。

初始化完成的最低交付

初始化后，工作区至少应具备：

memory/
├── YYYY-MM-DD.md
└── topics/
    └── index.md

并且工作区 AGENTS.md 中应具备最小必要的项目记忆常驻规则。

如果工作区里已经存在旧 topic，初始化应完成分类并汇报状态；但不应自动创建新项目档案，也不应自动拆分旧 topic 结构。