记忆文件臃肿、重复或过时时：拆分/合并/清理并重构…

当 agent 的 MEMORY.md 超过约 500 行、daily notes 累积未整合，或记忆文件出现臃肿、重复、过时、组织混乱时，用于拆分、合并、清理并重构记忆文件。

适用场景

解决思路

1. 盘点所有记忆文件：列出 `MEMORY.md`（长期记忆）、`memory/`（每日笔记、任务、主题文件）、`memory/tasks/`（进行中和已完成任务）。
2. 对每个文件记录：行数、最后修改时间、主题覆盖范围、过时程度。
3. 识别臃肿文件：当文件超过 300 行且覆盖多个主题时，拆分为聚焦文件。
4. 识别重复信息：同一事实出现在多个位置时，合并到一个位置。
5. 识别过时条目：对已完成工作、旧日期、已解决问题的引用，删除或归档。
6. 识别孤儿文件：审查 `memory/` 中从未被引用或更新的文件，然后合并或移除。
7. 识别不一致：跨文件存在矛盾信息时，解析到 ground truth（唯一可信来源）。
8. 识别组织问题：相关信息散落在多个文件时，按主题重构。
9. 识别递归嵌套：发现 `memory/memory/memory/...` 目录时，删除嵌套目录（索引器 bug 产物）。
10. 编辑前写简短计划：用 markdown checklist 列出要拆分、删除、合并、更新的事项。
11. 执行时一次只应用一项变更。
12. 拆分：从大文件中抽取章节到聚焦的主题文件。
13. 合并：把相关小文件组合成连贯文档。
14. 修剪：移除不再相关或不准确的信息。
15. 重构：移动文件到合适目录，重命名以提高清晰度。
16. 更新：修正过时事实、日期、状态。
17. 变更后验证没有信息丢失：对比修改前后。
18. 更新文件之间的交叉引用。
19. 在当天 daily note 记录：`## Memory Defrag (HH:MM)`、`Files reviewed: N`、`Split: [list]`、`Merged: [list]`、`Pruned: [list]`、`Net result: X files, Y total lines (was Z lines)`。
20. 保留原始 daily notes：不要删除或修改 `memory/YYYY-MM-DD.md` 文件，它们是审计追踪。
21. 目标为 15-25 个聚焦文件：太少意味着文件臃肿，太多意味着碎片化。
22. 文件名应可扫读：使用描述性名称如 `people.md`、`project-status.md`、`competitive-landscape.md`，而不是 `notes-2.md`。
23. 不要过度组织：通常一层目录即可；`memory/tasks/` 和 `memory/competitive/` 可以，`memory/work/projects/active/basic-memory/notes/` 不行。
24. 处理已完成任务：`status: done` 超过 14 天的任务可以移除；其洞见应已通过反思进入 `MEMORY.md`。
25. 破坏性变更前先询问：不确定信息是否仍相关时，保留并加 `(review needed)` 标签，而不是删除。

适用边界 · 注意事项

• 没有 `MEMORY.md`、`memory/`、daily notes 等结构化记忆文件时不适用。
• 不允许或无法安全修改、删除记忆文件时不适用。
• 记忆文件很少且没有臃肿、重复、过时或组织混乱问题时，不需要运行。