前言¶
长对话或跨天续工时，Agent 往往只记得当前上下文：用户说过的事实、偏好、已踩过的坑，下一轮又要重讲一遍。同类任务失败原因也可能被重复触发。下面介绍 SkillHub 上的「终身成长」（@user_5f5835e5/ai-agent-memory），用纯文件、零依赖的方式，把会话内工作记忆和长期记忆落到磁盘，让 Agent 在会话开始先「想起来」，在过程中持续写入。
这是什么¶
「终身成长」是社区发布的 ai-agent 类 Skill，当前版本 1.0.5，坐标 @user_5f5835e5/ai-agent-memory，SkillHub 页面标注作者为 shiyi_prince，标签 requires_api_key=false，不依赖外部 API Key。
一句话定位：为任意支持读写的 Agent 提供持久化、基于文件的长短期记忆，减少忘上下文和重复犯同样错误；实现上只用 Agent 自带的读文件、写文件、grep 等能力，零额外依赖。
官方简介说明：在会话开始时用于召回已有知识；在工作过程中，当用户陈述事实/偏好/决策、纠正错误，或任务失败时，应触发记忆更新。记忆以普通 Markdown 文件存放在 .codebuddy/memory/ 下。
核心功能¶
根据 SkillHub 与技能简介，可核实的能力如下。
工作记忆（当前会话）¶
管理本轮会话的 working memory，与长期记忆分开，避免把临时上下文和可复用知识混在一起。
长期记忆（多类型）¶
长期层按用途区分（均为 Markdown 文件，目录根为 .codebuddy/memory/）：
| 类型 | 用途（按官方表述） |
|---|---|
| semantic | 语义类、可复用的知识 |
| episodic | 情节/经历类记录 |
| procedural | 流程、做法类记忆 |
| error-lesson | 从失败中沉淀的教训 |
官方未在公开页列出各子目录的固定文件名；启用 Skill 后，由 SKILL 指引 Agent 在该树下创建与维护文件。
触发时机¶
- 会话开始：召回（recall）既有长期与工作记忆，再进入任务。
- 会话进行中：用户给出事实、偏好或决策；用户纠正 Agent 错误；或某次任务失败——应写入或更新对应记忆，避免下次重复。
技术约束¶
- 存储：纯 Markdown，路径
.codebuddy/memory/。 - 依赖：无；不引入额外运行时，仅使用 Agent 原生文件工具。
安装与启用¶
SkillHub 页面给出的安装方式是：参照 SkillHub 安装说明，安装坐标 @user_5f5835e5/ai-agent-memory。
若本机已安装 skillhub CLI，安装时必须用 --dir 指向当前 Agent 实际使用的 skills 目录（装到默认 ./skills/ 可能不会被识别）。官方文档中的示例：
command -v skillhub && skillhub --version
未安装 CLI 时，可按 SkillHub 文档执行完整安装（节选）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将搜索名或坐标替换为 user_5f5835e5/ai-agent-memory，并指定目录，例如：
skillhub install user_5f5835e5/ai-agent-memory --dir <当前 Agent 的 skills 目录>
各客户端 skills 目录（摘自 SkillHub 安装文档，以你本机环境为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可在对话中让 Agent 根据 https://skillhub.cn/install/skillhub.md 完成安装。安装后按所用客户端要求重载或新开会话，使 Skill 生效。
公开资料未单独说明 Cursor / Codex / Claude Code 在「记忆目录」上的差异；记忆路径统一写在 .codebuddy/memory/（相对当前工作项目或 Agent 约定的工作区，以 SKILL 内说明为准）。
典型用法¶
以下流程来自官方简介中的使用节奏，可在本地复现验证。
1. 新会话开头
让 Agent 先执行本 Skill 的召回步骤，读取 .codebuddy/memory/ 下已有 Markdown，再回答或写代码。例如你可以明确说：「按终身成长 Skill，先加载记忆再继续。」
2. 用户侧产生可记忆信息时
- 陈述稳定事实或偏好（技术栈、命名规范、部署环境等）。
- 做出需要后续遵守的决策。
- 纠正 Agent 的错误理解。
- 某步骤失败（构建失败、错误配置等）。
此时应让 Agent 按 Skill 指引写入或更新对应类型的记忆文件，而不是只留在当轮上下文里。
3. 跨会话
同一项目目录下保留 .codebuddy/memory/（建议纳入版本管理策略时只提交脱敏后的条目），下次打开会话重复步骤 1，即可延续语义、流程与 error-lesson，减轻「又问一遍」和「又踩同一坑」。
官方页面简介中留有问题反馈微信（见 SkillHub 技能详情），与功能实现无关，按需联系发布者。
适用场景与注意¶
适合谁
- 长期维护同一仓库或同一产品，需要和 Agent 共享项目约定、历史决策与失败教训。
- 希望记忆可审计、可 diff，不想绑死在单一 SaaS 记忆服务上。
- 环境允许 Agent 读写工作区文件（grep / read / write）。
限制与注意
- 记忆质量取决于何时触发写入；若未在纠正或失败时更新文件，行为仍会像「无记忆」。
- 目录名为
.codebuddy/memory/，与 CodeBuddy 生态命名一致；在其他 Agent 中使用时以 Skill 说明与工作区根路径为准。 - SkillHub 统计（以抓取资料为准）：评分 100000，下载 1191 次；
requires_api_key=false。无第三方 Key 不代表可忽略隐私：记忆文件可能含内部信息，注意权限与提交范围。 - 公开页未提供独立服务端；备份与同步需自行用 Git、网盘或团队规范处理。
结尾¶
「终身成长」把 Agent 记忆拆成会话内工作与长期语义/情节/流程/错误教训四类 Markdown，放在 .codebuddy/memory/，在会话开始召回、在事实与失败发生时写入，依赖为零。若你要在 SkillHub 查看版本与安装提示，可打开：
- SkillHub 页面：https://www.skillhub.cn/skills/user_5f5835e5/ai-agent-memory
- API 条目：https://api.skillhub.cn/user_5f5835e5/ai-agent-memory
