用途:为 AI 代理提供跨对话持久化的记忆空间,保存值得留存的知识,并在开始相关工作前检索已有记忆。触发场景包括“记住这个”“保存这个”“记一下”“我们之前讨论过什么”等。
主要能力:保存研究发现、代码库中不明显的模式或陷阱、棘手问题的解决方案、架构决策及其理由;按需整理记忆,合并同一主题的分散内容,删除过时或被取代的信息。
存储位置:.claude/skills/agent-memory/memories/。可自由建立分类文件夹,无预定义结构,文件夹与文件名使用 kebab-case。示例结构包含 file-processing、dependencies、project-context 等目录。
格式要求:每个记忆文件必须包含 frontmatter 的 summary 字段,用于判断是否需要阅读全文;created 为必填,updated、tags、related 为可选。
检索流程:先列出分类目录,再用 rg 查看所有 summary,按关键词或标签搜索摘要,必要时全文搜索,最后读取具体文件。注意记忆文件被 gitignore,使用 ripgrep 时需加 --no-ignore 与 --hidden。
保存操作:确定合适分类,检查是否已有分类或新建,用 date +%Y-%m-%d 获取当前日期,写入带 frontmatter 的文件;写入前检查文件是否存在以避免覆盖。维护操作包括更新内容并添加 updated 字段、用 trash 删除不再相关的记忆并清理空目录、合并相关记忆、随知识库演进重新归类。
使用建议:为未来的自己写作,保留足够上下文;摘要要能决定是否读全文;保持信息最新;只保存真正有用的内容。
限制:资料未提供安装方式、平台支持、收费模式或与其他工具的集成说明。