AgentMemory Skill

AgentMemory Skill 是什么

AgentMemory Skill 是面向 AI 代理的轻量持久记忆库，用于跨会话记住事实、记录行动经验并追踪人物、项目等实体。默认把数据保存在用户目录下的 SQLite 数据库。

适用场景

适合长期助理、项目代理和需要从成功或失败中积累经验的工作流；一次性任务或高度敏感对话不一定需要持久化。

核心能力与工作机制

它提供 remember、learn、recall、get_lessons 和 track_entity 等接口，可按标签查事实、按上下文取经验，并在会话开始加载、结束提取耐久信息。

执行流程

安装库并创建 AgentMemory 实例，任务开始时查询最近教训和相关实体；过程中只记录稳定事实，结束时写入经验与更新实体，后续通过搜索重新调用。

输入与输出

需要要保存的事实、标签、行动上下文、结果、经验或实体属性；临时闲聊、未经确认的推断和秘密信息不应自动入库。输出是查询到的事实、经验与实体记录，持久数据默认写入用户目录的 memory.db；也可指定其他数据库路径。

依赖、账号与权限

需要 Python 包及本地 SQLite 文件读写权限。清单未声明云端服务或 API Key，但安装说明中的命令拼写应在执行前核对来源。

副作用、限制与风险

持久记忆可能积累个人信息、错误事实和过时经验。清单很短，未说明删除、加密、迁移和并发策略，生产使用前需检查实现代码与数据治理能力。会在本地创建和更新数据库，跨会话保留内容；写入前应明确保存范围，用户要求删除时必须能定位并清除相关记录。

不适用边界

它不会训练模型或保证每次都正确调用记忆，也不是企业级知识库、访问控制或备份系统；高敏感数据应使用专门安全存储。

失败处理与验收

数据库不可写或损坏时应降级为当前会话并备份原文件，不能反复初始化覆盖；召回不准时检查标签与上下文，不将空结果解释为事实不存在。重启会话后查询测试事实与实体，检查路径、去重、过期和删除行为；审计数据库不含令牌、密码和不必要隐私。

适合谁使用

适合开发本地长期代理的工程人员，简单的短期上下文管理可以直接使用会话记录。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前安全扫描状态为 benign、benign；扫描状态只是平台信号，不能替代脚本、依赖、网络请求与后续版本的人工审查。

常见问题

1. AgentMemory Skill 主要解决什么问题？

AgentMemory Skill 是面向 AI 代理的轻量持久记忆库，用于跨会话记住事实、记录行动经验并追踪人物、项目等实体。默认把数据保存在用户目录下的 SQLite 数据库。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

2. 开始前需要准备哪些输入？

需要要保存的事实、标签、行动上下文、结果、经验或实体属性；临时闲聊、未经确认的推断和秘密信息不应自动入库。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

3. 它会怎样完成任务并交付结果？

安装库并创建 AgentMemory 实例，任务开始时查询最近教训和相关实体；过程中只记录稳定事实，结束时写入经验与更新实体，后续通过搜索重新调用。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

4. 需要哪些工具、账号或权限？

需要 Python 包及本地 SQLite 文件读写权限。清单未声明云端服务或 API Key，但安装说明中的命令拼写应在执行前核对来源。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

5. 它会修改文件或调用外部服务吗？

会在本地创建和更新数据库，跨会话保留内容；写入前应明确保存范围，用户要求删除时必须能定位并清除相关记录。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

6. 哪些场景不应该依赖这个 Skill？

它不会训练模型或保证每次都正确调用记忆，也不是企业级知识库、访问控制或备份系统；高敏感数据应使用专门安全存储。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

7. 失败、超时或结果异常时怎样恢复？

数据库不可写或损坏时应降级为当前会话并备份原文件，不能反复初始化覆盖；召回不准时检查标签与上下文，不将空结果解释为事实不存在。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。

8. 如何验收结果并控制风险？

重启会话后查询测试事实与实体，检查路径、去重、过期和删除行为；审计数据库不含令牌、密码和不必要隐私。实际使用时还要结合当前版本、真实数据、账号权限和运行环境复核，重要任务保留人工确认与原始证据。