用途:该技能直接编辑磁盘上的智能体记忆文件,把庞大、多用途的记忆块拆分成单一用途的组件,重点在“拆解”而非合并,适用于记忆块冗余、缺少结构、存在矛盾、内容过时,或项目里程碑后、每 50–100 轮对话时维护。
依赖与检查:需要启用 Memory Filesystem(memfs)。若系统提示中出现以 /memory/ 开头并含 system/ 目录的 memory_filesystem 块,则已启用;否则请用户运行 /memfs enable 并重新加载 CLI。
主要流程:记忆文件位于 ~/.letta/agents/$LETTA_AGENT_ID/memory/,CLI 启动时由 memfs sync 自动同步到 API 块。第一步必须在记忆目录的 git 仓库中提交当前状态作为回滚点:cd ~/.letta/agents/$LETTA_AGENT_ID/memory、git add -A、git commit -m "chore: pre-defrag snapshot"。第二步派生 memory 子代理(run_in_background 为 true),在 memory/system/ 中就地分析、拆解、加 markdown 结构、删除冗余与推测、解决矛盾,并用层级命名创建新文件,如 persona/identity.md、project/overview.md、project/tooling/bun.md;不要编辑 memory_filesystem.md 和 .sync-state.json。第三步子代理完成后提交:git add -A、git commit -m "chore: defragment memory blocks"、git push。
限制与回滚:文件路径相对记忆根形成块标签,新建文件产生新块,删除文件导致对应块被删除;YAML frontmatter 可设 label、description、limit、read_only。回滚可用 git reset --hard HEAD~1 或指定提交后 git push --force,下次 CLI 启动由 memfs sync 更新 API 块。子代理不执行 git 命令,由父代理处理。