memory-reflect

Memory Reflect

回顾近期活动，并将有价值的见解整合到长期记忆中。

灵感来自睡眠时计算——记忆最适合在活跃会话之间形成，而不是在会话进行期间形成。

何时运行

• Cron/heartbeat：将其安排为定期后台任务（建议每天运行 1～2 次）
• 按需运行：用户要求回顾、整合或检查近期记忆时
• 压缩后：上下文窗口压缩后

流程

1. 收集近期材料

找出近期有哪些变化，然后阅读相关文件：

# Find recently modified notes — use json format for the complete list
# (text format truncates to ~5 items in the summary)
recent_activity(timeframe="2d", output_format="json")

# Read specific daily notes
read_note(identifier="memory/2026-02-27")
read_note(identifier="memory/2026-02-26")

# Check active tasks
search_notes(note_types=["task"], status="active")

2. 判断哪些内容值得保留

针对每条信息，思考：

• 这是会影响后续工作的决策吗？→ 保留
• 这是经验教训或应避免的错误吗？→ 保留
• 这是偏好或工作方式方面的见解吗？→ 保留
• 这是关于关系的细节（谁负责什么、联系方式）吗？→ 保留
• 这是短暂的信息（查看天气、heartbeat 运行、例行任务）吗？→ 跳过
• 这已经记录在 MEMORY.md 或其他长期文件中了吗？→ 跳过

3. 更新长期记忆

按照现有结构，将整理后的见解写入 MEMORY.md：

• 新增章节或更新现有章节
• 使用简洁、客观的语言
• 添加日期以提供时间背景
• 删除或更新已被新信息取代的过时条目

4. 记录回顾结果

在今天的每日记录末尾添加一条简短记录：

## Reflection (HH:MM)
- Reviewed: [list of files reviewed]
- Added to MEMORY.md: [brief summary of what was consolidated]
- Removed/updated: [anything cleaned up]

指南

• 有所取舍。 目标是提炼，而非重复。MEMORY.md 应保存经过筛选的经验智慧，而不是每日记录的副本。
• 保持原有语气。 如果 Agent 有个性或灵魂文件，回顾内容应与其语气一致。
• 不要删除每日记录。 它们是原始记录。回顾的作用是从中提取信息，而不是取而代之。
• 合并，而非追加。 如果 MEMORY.md 中已有相关主题的章节，应就地更新，而不是添加重复条目。
• 标记不确定性。 如果某项内容看起来很重要，但无法确定，可添加“（需要确认）”之类的备注，而不是直接跳过。
• 随时间调整结构。 如果 MEMORY.md 是按时间顺序堆积的内容，应在回顾时将其重组为主题章节。经过整理的知识 > 原始日志。
• 检查文件系统问题。 收集材料时，留意递归嵌套（memory/memory/memory/...）、孤立文件或内容臃肿等问题。