memory-sync（记忆同步）是什么？

memory-sync 是一个 AI 智能体技能，旨在解决会话之间“冷启动”的问题。它通过在会话开始时自动加载结构化的记忆文件（如 MEMORY.md 和热/温分层记忆），使智能体能够快速恢复上下文，避免每次从头开始。会话结束时，该技能会运行同步命令，将当前会话的日志蒸馏到核心记忆文件（MEMORY.md）中，修剪过期内容，并在必要时生成简短的架构决策记录（ADR）。该技能适用于多种智能体平台（如 Claude Code、Cursor），其记忆系统采用文件结构进行分层管理：热层（hot.md）始终加载，温层（warm.md）按需加载，冷层（cold/）仅供显式引用。此外，还支持 raw session 笔记的自动清理（约 30 天后）和敏感信息的自动脱敏。

兼容平台~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/TheElephantCoder/agent-harness/tree/main/skills/memory-sync

文档

记忆同步

防止会话从冷启动开始。

布局

memory/
  MEMORY.md        # 精选内容，始终加载，控制在 8k 以内
  SOUL.md          # 智能体的身份
  USER.md          # 你的身份
  sessions/        # 原始会话笔记，约 30 天后清理
  decisions/       # 简短的架构决策记录（ADR）
  tiers/
    hot.md         # 始终加载
    warm.md        # 根据关键词按需加载
    cold/          # 仅显式读取

生命周期

启动：读取 MEMORY.md 和 tiers/hot.md。如果任务匹配，可能读取 warm.md。除非需要深入历史，否则不要读取 sessions/。整个过程应在 15 秒内完成。

结束：运行 harness memory sync 或让退出钩子自动执行。它会将会话日志蒸馏到 MEMORY.md 中，修剪旧内容，并在你做出真正决策时添加一条 ADR。

提示

MEMORY.md 是精选的，不是追加式写入。请保持内容在 8k token 以内，进行精确编辑。
如果你考虑过 2 个以上的方案并选择了其中一个，请写一条简短的 decisions/ADR-###.md。
不要在记忆中存放机密信息，它们会被自动脱敏。

命令：

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto

memory-sync（记忆同步）