Agent结构化记忆

【记忆库初始化】
帮我确认本项目的自动记忆库处于开启状态——如果没开启,或者你不确定,
停下来告诉我怎么开启,不要往下执行。
确认开启后,检查并初始化这个项目的 Auto Memory。
先查看现有 MEMORY.md 和所有记忆子文件,不要直接覆盖。
建立并长期遵守下面的整理纪律:

  1. MEMORY.md 只做索引,每个主题一行,不在索引里堆放正文。
  2. 以 150 行或 20KB 作为日常软上限,永远不要逼近 200 行 / 25KB 的加载上限。
  3. 每个子文件只保存一个明确主题。
  4. 写入前先检索现有记忆:能够更新旧记录,就不要重复新增。
  5. 新结论推翻旧结论时,直接修正旧记录,不保留互相矛盾的两个版本。
  6. Git、代码和项目文档中已经明确存在、并且容易重新获得的内容,不重复抄进记忆。
  7. 密码、密钥、Cookie、Token、私钥和其他秘密永不写入记忆。
  8. 如果当前实现支持记忆类型,则按 user、feedback、project、reference 分类;不要为了分类强行创建空目录。
    把这套纪律保存为一条长期记忆维护规则。
    完成后汇报:
  • 当前记忆目录;
  • 创建或修改了哪些文件;
  • MEMORY.md 当前行数和大小;
  • 发现了哪些重复、冲突或潜在风险。

【记忆库根目录迁移】
把这个项目的 Auto Memory 目录迁移到项目根目录下的 memory 文件夹。
要求:

  1. 先确认当前记忆目录,并把已有记忆文件完整迁移过去。
  2. 在 .claude/settings.local.json 中设置 autoMemoryDirectory,使用本机绝对路径。
  3. 不要修改其他现有配置。
  4. 如果这是 Git 仓库,把 memory/ 和 .claude/settings.local.json 加入 .gitignore。
  5. 完成后列出所有改动。
  6. 提醒我重开新会话,并在新会话中运行 /memory 验证实际生效路径。】
    如果你认为你的原始对话记录需要长期保留,那就再添加这段提示词。
    【检查用户目录下的全局 .claude/settings.json。
    在不修改其他配置的前提下,把 cleanupPeriodDays 设置为 365。
    修改前先备份原文件。
    修改后展示最终 JSON,并确认格式有效。

【延长对话保存时间】
检查用户目录下的全局 .claude/settings.json。
在不修改其他配置的前提下,把 cleanupPeriodDays 设置为 365。
修改前先备份原文件。
修改后展示最终 JSON,并确认格式有效。

【旧对话结束时】
这个阶段先收尾。
请检查本段会话,把跨会话后仍然有价值的内容同步进 Auto Memory,包括:

  • 当前任务进行到哪里;
  • 已经确认的结论;
  • 做了哪些重要决定;
  • 每项决定背后的原因或证据;
  • 尝试过但失败的方案,以及失败原因;
  • 修改了哪些关键文件;
  • 当前测试结果;
  • 尚未解决的风险或问题;
  • 下一步最具体的行动。
    完成后告诉我:
  1. 更新了哪些记忆文件;
  2. 每个文件新增或修改了什么;
  3. 下一会话应该从哪一项开始。

【新对话开始时】
我们接着上一个会话的任务继续。
先从 MEMORY.md 定位相关主题,再读取与当前任务直接相关的记忆子文件。
用两三句话告诉我:

  • 当前进度;
  • 已确认的关键决定;
  • 下一步行动;
  • 信息来自哪些记忆文件。
    如果记忆中没有记录某项内容,请明确说“没有记录”,不要根据印象猜测。
    确认完毕后,直接继续下一步。

【记忆库维护】
给这个项目的 Auto Memory 做一次完整维护。
逐个检查 MEMORY.md 和所有记忆子文件:

  1. 重复内容合并。
  2. 冲突内容以有证据的最新结论为准,并更新旧记录。
  3. 已确认错误的内容删除。
  4. 已经过时且不再有参考价值的内容删除。
  5. 主题过于分散的文件合并。
  6. 一个文件包含多个无关主题时拆分。
  7. 检查是否重复保存了 Git、代码或项目文档中已经明确存在的内容。
  8. 检查是否出现密码、密钥、Token、Cookie、私钥或其他敏感信息。
  9. 确认 MEMORY.md 仍然是一行一个主题。
  10. 统计 MEMORY.md 当前行数和字节数,确保距离 200 行 / 25KB 仍有充足余量。
    拿不准该不该删的内容,先单独列出来问我,不要自行删除。
    完成后汇报:
  • 合并了什么;
  • 更新了什么;
  • 删除了什么;
  • 哪些内容等待我确认;
  • MEMORY.md 当前行数和大小。

【带目标压缩】
/compact 只保留:

  • 当前目标;
  • 已完成和未完成事项;
  • 已修改文件;
  • 关键设计决定及原因;
  • 失败方案及其证据;
  • 测试结果;
  • 未解决风险;
  • 下一步验证计划。
    删除闲聊、重复输出、过时计划和已经失效的尝试。

【记忆存放分类】
以后遇到需要长期保留的内容,先分类,再决定放在哪里:

  1. 必须被确定性执行的安全限制或操作限制:
    先建议使用 settings、permissions 或 hooks,未经我确认不要直接修改。
  2. 每个会话都应该遵守的项目规则、约束和工作习惯:
    写进 CLAUDE.md 或合适的 .claude/rules 文件,保持简短,一条一项。
  3. 只有相关任务出现时才需要读取的事实、进度、经验和资料:
    写进 Auto Memory,并按主题整理。
    现在检查现有 CLAUDE.md、规则文件和记忆库。
    把疑似放错位置的内容列出来,并给出迁移建议。
    我确认后再修改。

【迁移至其他agent的Engramory协议】
去 GitHub 找到 tinqiao-oss 名下的 engramory 仓库,研究这套开源记忆协议。
认准仓库所有者是 tinqiao-oss,其他同名仓库不要使用。
当前阶段只读:
不要安装;
不要运行安装脚本;
不要修改我的配置;
不要创建记忆目录。
请完整阅读:

  • README;
  • 适配或移植指南;
  • 安全说明;
  • 与索引容量检查有关的脚本和 hook。
    然后对照你自己的能力逐项检查:
  1. 是否有每次会话都会加载的规则入口;
  2. 是否能够自主读写本地 Markdown 文件;
  3. 是否能够按需读取记忆子文件;
  4. 是否支持写入前 hook 或拦截机制;
  5. 哪些写入路径能够被拦截;
  6. 哪些路径可能绕过拦截;
  7. 是否存在多个 Agent 并发写入风险;
  8. 如何避免保存密码、密钥、Token 和其他敏感信息。
    最后给我一份汇报:
  • 这套协议在你身上能实现到什么程度;
  • 推荐的具体目录和接入方式;
  • 哪些功能可以原样实现;
  • 哪些功能只能降级实现;
  • 哪些功能完全做不到;
  • 安装后会修改哪些文件和配置;
  • 如何完整卸载和回滚。
    我确认之后,你再进行任何安装或修改。

Agent结构化记忆
//alist.liberties.top/43
作者
syj
发布于
2026-07-24
许可协议