Agent结构化记忆
【记忆库初始化】
帮我确认本项目的自动记忆库处于开启状态——如果没开启,或者你不确定,
停下来告诉我怎么开启,不要往下执行。
确认开启后,检查并初始化这个项目的 Auto Memory。
先查看现有 MEMORY.md 和所有记忆子文件,不要直接覆盖。
建立并长期遵守下面的整理纪律:
- MEMORY.md 只做索引,每个主题一行,不在索引里堆放正文。
- 以 150 行或 20KB 作为日常软上限,永远不要逼近 200 行 / 25KB 的加载上限。
- 每个子文件只保存一个明确主题。
- 写入前先检索现有记忆:能够更新旧记录,就不要重复新增。
- 新结论推翻旧结论时,直接修正旧记录,不保留互相矛盾的两个版本。
- Git、代码和项目文档中已经明确存在、并且容易重新获得的内容,不重复抄进记忆。
- 密码、密钥、Cookie、Token、私钥和其他秘密永不写入记忆。
- 如果当前实现支持记忆类型,则按 user、feedback、project、reference 分类;不要为了分类强行创建空目录。
把这套纪律保存为一条长期记忆维护规则。
完成后汇报:
- 当前记忆目录;
- 创建或修改了哪些文件;
- MEMORY.md 当前行数和大小;
- 发现了哪些重复、冲突或潜在风险。
【记忆库根目录迁移】
把这个项目的 Auto Memory 目录迁移到项目根目录下的 memory 文件夹。
要求:
- 先确认当前记忆目录,并把已有记忆文件完整迁移过去。
- 在 .claude/settings.local.json 中设置 autoMemoryDirectory,使用本机绝对路径。
- 不要修改其他现有配置。
- 如果这是 Git 仓库,把 memory/ 和 .claude/settings.local.json 加入 .gitignore。
- 完成后列出所有改动。
- 提醒我重开新会话,并在新会话中运行 /memory 验证实际生效路径。】
如果你认为你的原始对话记录需要长期保留,那就再添加这段提示词。
【检查用户目录下的全局 .claude/settings.json。
在不修改其他配置的前提下,把 cleanupPeriodDays 设置为 365。
修改前先备份原文件。
修改后展示最终 JSON,并确认格式有效。
【延长对话保存时间】
检查用户目录下的全局 .claude/settings.json。
在不修改其他配置的前提下,把 cleanupPeriodDays 设置为 365。
修改前先备份原文件。
修改后展示最终 JSON,并确认格式有效。
【旧对话结束时】
这个阶段先收尾。
请检查本段会话,把跨会话后仍然有价值的内容同步进 Auto Memory,包括:
- 当前任务进行到哪里;
- 已经确认的结论;
- 做了哪些重要决定;
- 每项决定背后的原因或证据;
- 尝试过但失败的方案,以及失败原因;
- 修改了哪些关键文件;
- 当前测试结果;
- 尚未解决的风险或问题;
- 下一步最具体的行动。
完成后告诉我:
- 更新了哪些记忆文件;
- 每个文件新增或修改了什么;
- 下一会话应该从哪一项开始。
【新对话开始时】
我们接着上一个会话的任务继续。
先从 MEMORY.md 定位相关主题,再读取与当前任务直接相关的记忆子文件。
用两三句话告诉我:
- 当前进度;
- 已确认的关键决定;
- 下一步行动;
- 信息来自哪些记忆文件。
如果记忆中没有记录某项内容,请明确说“没有记录”,不要根据印象猜测。
确认完毕后,直接继续下一步。
【记忆库维护】
给这个项目的 Auto Memory 做一次完整维护。
逐个检查 MEMORY.md 和所有记忆子文件:
- 重复内容合并。
- 冲突内容以有证据的最新结论为准,并更新旧记录。
- 已确认错误的内容删除。
- 已经过时且不再有参考价值的内容删除。
- 主题过于分散的文件合并。
- 一个文件包含多个无关主题时拆分。
- 检查是否重复保存了 Git、代码或项目文档中已经明确存在的内容。
- 检查是否出现密码、密钥、Token、Cookie、私钥或其他敏感信息。
- 确认 MEMORY.md 仍然是一行一个主题。
- 统计 MEMORY.md 当前行数和字节数,确保距离 200 行 / 25KB 仍有充足余量。
拿不准该不该删的内容,先单独列出来问我,不要自行删除。
完成后汇报:
- 合并了什么;
- 更新了什么;
- 删除了什么;
- 哪些内容等待我确认;
- MEMORY.md 当前行数和大小。
【带目标压缩】
/compact 只保留:
- 当前目标;
- 已完成和未完成事项;
- 已修改文件;
- 关键设计决定及原因;
- 失败方案及其证据;
- 测试结果;
- 未解决风险;
- 下一步验证计划。
删除闲聊、重复输出、过时计划和已经失效的尝试。
【记忆存放分类】
以后遇到需要长期保留的内容,先分类,再决定放在哪里:
- 必须被确定性执行的安全限制或操作限制:
先建议使用 settings、permissions 或 hooks,未经我确认不要直接修改。 - 每个会话都应该遵守的项目规则、约束和工作习惯:
写进 CLAUDE.md 或合适的 .claude/rules 文件,保持简短,一条一项。 - 只有相关任务出现时才需要读取的事实、进度、经验和资料:
写进 Auto Memory,并按主题整理。
现在检查现有 CLAUDE.md、规则文件和记忆库。
把疑似放错位置的内容列出来,并给出迁移建议。
我确认后再修改。
【迁移至其他agent的Engramory协议】
去 GitHub 找到 tinqiao-oss 名下的 engramory 仓库,研究这套开源记忆协议。
认准仓库所有者是 tinqiao-oss,其他同名仓库不要使用。
当前阶段只读:
不要安装;
不要运行安装脚本;
不要修改我的配置;
不要创建记忆目录。
请完整阅读:
- README;
- 适配或移植指南;
- 安全说明;
- 与索引容量检查有关的脚本和 hook。
然后对照你自己的能力逐项检查:
- 是否有每次会话都会加载的规则入口;
- 是否能够自主读写本地 Markdown 文件;
- 是否能够按需读取记忆子文件;
- 是否支持写入前 hook 或拦截机制;
- 哪些写入路径能够被拦截;
- 哪些路径可能绕过拦截;
- 是否存在多个 Agent 并发写入风险;
- 如何避免保存密码、密钥、Token 和其他敏感信息。
最后给我一份汇报:
- 这套协议在你身上能实现到什么程度;
- 推荐的具体目录和接入方式;
- 哪些功能可以原样实现;
- 哪些功能只能降级实现;
- 哪些功能完全做不到;
- 安装后会修改哪些文件和配置;
- 如何完整卸载和回滚。
我确认之后,你再进行任何安装或修改。