1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | deep-agents-memory-langchain-ai-langchain-skills（SKILL.md 内部名称 deep-agents-memory） |
GitHub |
| 作者/维护者 | LangChain（langchain-ai 官方组织，LangGraph、LangChain、Deep Agents 框架的开发方） |
GitHub API + plugin.json |
| 来源链接 | https://github.com/langchain-ai/langchain-skills/tree/main/config/skills/deep-agents-memory | — |
| 许可证 | MIT（声明于仓库 .claude-plugin/plugin.json 的 license 字段；仓库根目录未附独立 LICENSE 文件，曾有开发者因此在 Issue 中询问许可证情况） |
GitHub API + 仓库文件 |
| GitHub Stars/Forks | 所属合集仓库 langchain-ai/langchain-skills 整体 1,109★/85 forks（覆盖 21 个不同子技能，不代表本技能自身热度） |
GitHub API |
| 最新版本 | 0.1.0（plugin.json 声明；README 注明项目处于早期阶段，API 与技能内容可能变化） | GitHub |
| 安装方式 | npx skills add langchain-ai/langchain-skills --skill deep-agents-memory --yes |
GitHub README |
2. 功能介绍与亮点
Deep Agents（LangChain 官方在 LangGraph 之上封装的高层 Agent 框架）把文件读写与记忆抽象成可插拔的“后端”。这个技能是该抽象层的配置速查手册，讲清楚该在什么场景选哪种后端、怎么组合、以及踩坑之后怎么修。
主要亮点：
- 四态后端选型表：把“临时工作文件 / 本地开发直接读盘 / 跨会话长期记忆 / 混合存储”四类真实场景，一一对应到
StateBackend（线程内易失）、FilesystemBackend（本地磁盘）、StoreBackend（跨线程持久化）、CompositeBackend（按路径前缀路由到不同后端）。 - Python 与 TypeScript 双语言示例：每种后端配置、每个踩坑修复都配两种语言的可直接复制代码。
- 明确的能力边界（boundaries）：单列一节说明 Agent 能配置什么（后端类型、路由规则、根目录）、不能配置什么（工具名、
virtual_mode限制之外的路径、未正确设置后端时的跨线程访问），并直接给出安全警告——“生产 Web 服务中不要用FilesystemBackend，应改用StateBackend或沙箱”。 - 六个高频踩坑修复对照：
StoreBackend忘记传store实例、StateBackend文件不能跨线程读取、CompositeBackend路径前缀不匹配导致未持久化、生产环境应使用PostgresStore而非InMemoryStore、virtual_mode未开启导致../、~/路径穿越风险、多前缀路由时的“最长前缀优先”匹配规则——均为“错误写法 vs 正确写法”直接对照。
3. 适用场景
所属分类：元技能与 Agent 增强
适合正在用 LangChain 官方 Deep Agents 框架构建长任务型 Agent、需要让 Agent 记住跨会话用户偏好、或需要控制 Agent 能否直接读写本地磁盘文件的开发者。典型触发场景是“Agent 每次对话都忘记之前的设置”“想让 Agent 把草稿文件持久化保存”，或是要给一个会读写本地文件的 Agent 加上安全边界（防止越权访问项目目录之外的文件）。目标用户是已经采用 Deep Agents 高层框架、但还不熟悉其后端存储体系细节的中级开发者。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 明确列出 Claude Code，并提供专用的 Claude Code Plugin 安装方式（
/plugin marketplace add+/plugin install）。 - Codex：✅ 支持。README 在同仓库
eval-engineering技能的用法说明中直接给出“Or ask Codex: …“的调用示例，且全部技能共享同一套基于npx skills（Agent Skills 规范）的安装机制，可视为对 Codex 的官方支持。 - OpenClaw / Hermes Agent：❓ 未验证。抓取到的材料（README、SKILL.md）未提及这两个 agent。
5. 推荐理由
Deep Agents 的后端抽象把“存哪里、存多久”变成几行配置，但配错的代价往往是隐蔽的（文件悄悄丢失、以为持久化了实际没生效、Web 服务里误用本地磁盘后端造成越权风险）。这个技能由框架官方维护，把四种后端的适用边界、组合方式与六类高频踩坑整理成一份写代码时可随查随用的参考，且随框架版本同步更新。对正在给 Deep Agents 应用加跨会话记忆或文件能力的开发者，能显著减少“数据莫名丢失”“路径越权”这类结构性错误的排查成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 由 LangChain/LangGraph/Deep Agents 官方开发方 LangChain 发布并维护；所属合集仓库整体 1,109 stars 由 21 个子技能共享、不代表本技能自身热度；尚未检索到针对本技能自身的独立第三方报道或评测数据 |
| 可用性 | 9 | SKILL.md 单文件约 9.7KB，覆盖四类后端选型、组合路由、六类高频踩坑修复，均配 Python 与 TypeScript 双语言可直接复制代码；一条命令即可安装，核心用法不依赖任何付费第三方服务；仓库最近一次提交为 2026-08-07，维护活跃 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单：①技能本体是一份 Markdown 参考文档，不含可执行脚本，不涉及 shell 命令执行 ②技能本身运行时不联网、不外发数据（示例中 PostgresStore 连接的数据库是用户自己的部署，与技能本身无关）③不要求用户向本技能提供任何 API Key 或凭据 ④通读全文均为后端配置说明与代码示例，且主动提示“生产 Web 服务禁用本地磁盘后端”这类安全边界，未发现可疑指令或隐藏外发行为 ⑤LangChain 官方组织出品，langchain-ai 为该技术栈的官方开发方，无造假迹象 ⑥License 为 MIT，声明于仓库 plugin.json，含义明确 ⑦仓库最近一次提交为 2026-08-07，持续维护中
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
langgraph-persistence（同仓库姊妹技能） |
LangGraph 底层原语——Checkpointer、thread_id、跨线程 Store | 是更细粒度的原语层配置，需要自己管理更多细节；本技能面向 Deep Agents 更高一层的封装接口，配置更省心但控制粒度较粗，两者服务于不同抽象层级 |
| Mem0 | 独立的第三方记忆平台/API，提供用户级、会话级、Agent 级三层记忆抽象 | 需要接入托管服务或自行部署一套独立系统，且与具体 Agent 框架解耦；本技能是 LangChain 生态内置的轻量参考，不引入额外外部服务 |
| Letta（原 MemGPT） | 完整的 Agent 运行时框架，把内存管理做成操作系统式的分页机制（主上下文/召回库/归档库） | 采用它意味着接受整套 Agent 运行时约定；本技能只是一份可插拔的后端配置指南，可直接嵌入已有的 LangGraph/Deep Agents 项目，无需更换运行时 |
| LangMem | LangChain 官方的独立记忆库，提供语义/情景记忆自动抽取等更高级能力 | 定位是在存储之上再做一层记忆内容的提炼；本技能只负责“存到哪里、怎么路由”这一层，两者可以叠加使用而非互相替代 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。
9. 其他补充
LangChain 官方博客披露，在其内部基准测试中，接入该系列技能后 Claude Code 在相关任务上的通过率提升至 95%（该数据针对整套 21 个技能系列，非本技能单独测得，供参考）。同仓库还包含 deep-agents-core（Deep Agents 架构基础）、langgraph-persistence（LangGraph 原语层持久化）、deep-agents-orchestration（子任务编排）等围绕同一技术栈不同环节的姊妹技能，可按需单独安装。
10. 安装使用方式
- 单独安装本技能（推荐）：
npx skills add langchain-ai/langchain-skills --skill deep-agents-memory --yes；全局安装加--global - 指定安装到 Claude Code：
npx skills add langchain-ai/langchain-skills --agent claude-code --skill deep-agents-memory --yes --global - 作为 Claude Code 插件整包安装：
/plugin marketplace add langchain-ai/langchain-skills后/plugin install langchain-skills@langchain-skills（会装入该仓库全部子技能，而非仅此一个） - 安装后注意事项：无需配置 API Key 或环境变量即可使用本技能本身；若按文中示例接入
PostgresStore做生产级持久化，需自备 PostgreSQL 连接字符串；直接向 Agent 描述“给这个应用加上跨会话记忆”或“限制这个 Agent 只能读写项目目录内的文件”之类的需求即可触发调用
11. 注意事项
- README 明确标注项目处于早期阶段，API 与技能内容可能变化，长期跟踪建议关注仓库更新
- 内容聚焦 Deep Agents 高层后端抽象，不覆盖 LangGraph 底层 Checkpointer 原语（需另装同仓库的
langgraph-persistence） - 仓库未附独立 LICENSE 文件，MIT 许可仅声明于
.claude-plugin/plugin.json，比对时需留意这一细节 FilesystemBackend若在生产 Web 服务中使用且未正确设置virtual_mode，存在路径穿越风险，技能文中已给出明确警告，使用时应遵循