memory-defrag

记忆整理

重新整理记忆文件，让内容更清晰、高效且切题。就像整理文件系统碎片，只不过整理的是知识。

何时运行

• 定期：每周或每两周通过 cron 运行（推荐）
• 按需：用户要求清理、重组或整理记忆
• 达到阈值时：当 MEMORY.md 超过约 500 行，或每日笔记不断累积且未整合时

流程

1. 审查当前状态

盘点所有记忆文件：

MEMORY.md           — long-term memory
memory/             — daily notes, tasks, topical files
memory/tasks/       — active and completed tasks

对于每个文件，记录：行数、上次修改时间、涵盖主题及内容是否过时。

2. 找出问题

查找以下常见问题：

问题	信号	修复方法
文件臃肿	超过 300 行，涵盖多个主题	拆分为主题明确的文件
信息重复	同一事实出现在多个位置	整合到一个位置
条目过时	提及已完成的工作、旧日期或已解决的问题	删除或归档
孤立文件	memory/ 中的文件从未被引用或更新	审查、合并或删除
内容不一致	不同文件中的信息相互矛盾	以事实为准进行统一
组织不佳	相关信息散落在多个文件中	按主题重新组织
递归嵌套	memory/memory/memory/... 目录	删除嵌套目录（索引器错误产生的残留）

3. 规划变更

编辑前，先写一份简短计划：

## Defrag Plan
- [ ] Split MEMORY.md "Key People" section → memory/people.md
- [ ] Remove completed tasks older than 30 days from memory/tasks/
- [ ] Merge memory/bm-marketing-ideas.md into memory/competitive/
- [ ] Update stale project status entries in MEMORY.md

4. 执行

一次应用一项变更：

• 拆分：从大型文件中提取内容，放入主题明确的文件
• 合并：将相关的小文件合并为结构连贯的文档
• 精简：删除不再相关或准确的信息
• 重组：将文件移至合适的目录，并重命名以便识别
• 更新：修正过时的事实、日期和状态

5. 验证并记录

完成变更后：

• 确认没有信息丢失（比较变更前后）
• 更新文件间的交叉引用
• 在今天的每日笔记中记录完成的事项：

## Memory Defrag (HH:MM)
- Files reviewed: N
- Split: [list]
- Merged: [list]
- Pruned: [list]
- Net result: X files, Y total lines (was Z lines)

指南

• 保留原始每日笔记。 不要删除或修改 memory/YYYY-MM-DD.md 文件——它们是审计记录。
• 目标为 15–25 个主题明确的文件。 文件太少会导致内容臃肿；文件太多则会过度分散。尽量达到合适的数量。
• 文件名应便于浏览。 使用描述性名称：people.md、project-status.md、competitive-landscape.md，不要使用 notes-2.md。
• 不要过度组织。 通常一层目录就足够了。memory/tasks/ 和 memory/competitive/ 没问题；memory/work/projects/active/basic-memory/notes/ 则不合适。
• 已完成的任务：status: done 且已超过 14 天的任务可以删除。相关经验应已通过回顾记录在 MEMORY.md 中。
• 进行破坏性变更前先询问。 如果不确定某条信息是否仍然有用，请添加 (review needed) 标签并保留，而不是删除。