Agent Skills
返回列表
🤖

AgentMemory 持久项目记忆

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/give-coding-agents-persistent-project-memory-with-agentmemory。

技能介绍

编码代理为什么会「失忆」

Claude Code、Codex、Cursor、Gemini CLI 这类编码代理本质上是无状态的：每开一个新会话，它对项目的全部认知就清零了。上周为什么弃用方案 A、某个诡异的 bug 最后是怎么定位到依赖版本冲突的、哪段脚手架代码已经在三个模块里复制过一遍——这些信息要么散落在聊天记录里，要么只能让代理重新读一遍仓库。会话一结束，记忆也随之蒸发，下一个会话还得从头交代背景。

AgentMemory 如何工作

AgentMemory 是一个常驻的记忆服务。这个技能做的不是再写一套笔记工具，而是把代理接到这个服务上，让它在需要时主动召回项目上下文、历史决策和可复用的会话知识。

核心能力：

  • 跨会话持久化：项目背景、约定和决策记录在会话之外留存，不随对话结束而丢失
  • 决策召回：代理可以查询「为什么选 X 而不选 Y」，避免重复讨论或重新踩坑
  • 会话知识复用：上一轮摸索出的结论可以直接喂给下一轮，不必重讲背景

关键步骤：

  • 准备运行环境：Node.js 以及 npm / npx
  • 启动 AgentMemory 服务
  • 通过 MCP 协议挂载到编码代理端，兼容 Claude Code、Codex、Cursor、Gemini CLI、OpenClaw 等 MCP 客户端

适用边界与注意点

  • 版本缓存坑：npx 按版本缓存，如果上周用过 @0.9.14，不带版本号的调用可能继续命中本地缓存的旧版本，而不是最新 release
  • 全局安装提示：从 v0.9.16 起，首次运行会询问是否全局安装；跳过之后需要重新拉取才能拿到新版本
  • 权限问题：macOS / Linux 上系统级 Node 安装可能触发 EACCES，需要重试或调整执行方式
  • 多语言接入：除 MCP 客户端外，还提供 Python / Rust / Node 的程序化访问
  • 上游依赖：实现细节和文档以 AgentMemory 官方仓库为准，技能本身只做接入与说明

使用场景

  • 跨多个会话迭代同一项目时，让代理随时召回先前敲定的技术选型与架构决策，不用每次重讲背景。
  • 排查一个依赖版本冲突导致的历史 bug 时，直接查询 AgentMemory 里记录的先前定位结论，缩短排查路径。
  • 把一段已验证的脚手架代码及其使用约定存入记忆，让团队其他代理在别的模块里直接复用。
  • 在 Claude Code、Codex 或 Cursor 之间切换处理同一仓库时，保证各方共享同一份项目记忆。

适合人员

  • 独立开发者：一个人维护多个长期项目，靠代理续写代码却不想每次重述项目背景和历史决策。
  • 小团队技术负责人：需要让成员各自的编码代理共享同一套架构约定，避免决策口口相传、逐渐失真。
  • 频繁使用 Cursor 或 Codex 的全栈工程师：在不同会话间切换时希望历史调试结论和脚手架代码能直接复用。
  • 搭建 AI 编码流水线的基础设施工程师：负责把 AgentMemory 这类 MCP 服务接入现有客户端并维护版本一致性。