memory-skill
为AI智能体提供基于文件的长期记忆存储与检索能力。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:memory-skill。 它的用途是:为AI智能体提供基于文件的长期记忆存储与检索能力。 完整的 Skill 内容见:https://321skill.com/skills/memory-skill/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“记住用户小明喜欢用深色主题,并且是Python开发者。”,它会调用 `memory_write` 将这条偏好记录到记忆文件中。几天后,当用户再次对话时,AI可以说:“我记得您喜欢深色主题,这次需要我帮您写Python代码吗?”,这是通过 `memory_search` 检索“深色主题”和“Python”相关记忆实现的。
介绍
Memory Skill 解决了AI智能体在对话或任务执行过程中信息无法跨会话持久化的问题。它通过一个简单的JSONL文件存储记忆,确保智能体能够记住用户偏好、历史对话要点或任务上下文,从而提供更连贯、个性化的服务。
使用上,智能体可以通过 memory_write 功能将关键信息(如用户偏好、任务状态、学习笔记)以结构化的方式写入本地文件。当需要回忆时,通过 memory_search 功能,基于关键词或正则表达式从最近的记录中快速检索相关信息,并返回给智能体使用。
这个技能非常适合需要长期与用户互动、管理复杂项目或处理多轮对话的AI智能体开发者。无论是构建个人助手、客服机器人还是项目管理工具,都可以通过集成此技能来增强智能体的记忆能力。
建议在使用时,根据记忆文件的大小调整 window_lines 搜索窗口参数以平衡性能。由于采用纯文本存储,定期备份 ~/.codex/memory.jsonl 文件是保障数据安全的好习惯。同时,注意避免存储高度敏感的个人信息。
核心特点
核心区别在于其极简、透明的文件存储设计(单个append-only JSONL文件)和依赖标准Unix工具(如jq, ripgrep)的高效检索策略,无需复杂数据库,易于检查、备份和集成。
注意事项
不适合需要高速、复杂查询或存储海量结构化数据的场景。
常见问题
记忆文件存储在哪里?安全吗?
默认存储在用户主目录的 `~/.codex/memory.jsonl`,是本地纯文本文件,安全性取决于用户对文件的权限管理。
能和其他技能一起用吗?
可以,它是一个独立的技能,可以与其他处理笔记、任务或数据分析的技能协同工作,为其提供历史上下文。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/memory-skill/raw/index.md 读取 memory-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/memory-skill/raw/index.md(查看排版版本)