前言¶
在多轮对话里，Agent 往往只能依赖当前上下文窗口。关掉会话或换一台机器，用户偏好、项目约定、踩过的坑和做过的重要决策就接不上。常见做法是手写 MEMORY.md、散落笔记，或把历史塞进 RAG，但缺少统一分类、检索和元数据，维护成本偏高。
下面介绍 SkillHub 社区 Skill memory-skill（坐标 @user_4005c3e1/memory-skill，版本 1.0.0）：用工作区内的文件系统承载记忆，支持分类归档与检索，数据留在本地，可读可改。
这是什么¶
memory-skill 是一套面向 AI Agent 的长期记忆技能，发布者为 user_4005c3e1，来源为 community，在 SkillHub 上归类为 ai-agent。官方说明其目标是让 Agent 在多次会话之间保留结构化信息，而不是每次从零复述背景。
与「只靠对话历史」或「单一大段备忘文件」相比，它把记忆拆成多种用途（偏好、项目背景、教训、决策、日摘要、调研归档），并配合关键词检索、Qwen3-Rerank 精排和 YAML 元数据，便于 Agent 写入与召回。页面标注 requires_api_key=false，表示安装该 Skill 本身不强制绑定外部 API Key（精排等能力是否另有依赖，以 Skill 包内 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在资料中出现的细节不展开。
- 用户偏好记忆：编码风格、沟通习惯、常用工具选择等跨会话偏好。
- 项目背景记录：仓库结构、业务术语、当前迭代目标等上下文。
- 错误教训积累：已验证的故障原因与修复方式，减少重复踩坑。
- 决策历史追踪：架构或方案取舍及理由，方便后续对齐。
- 每日会话摘要：按日压缩会话要点，降低长对话占满上下文的风险。
- 外部调研资料归档：调研结论、链接与摘要的本地留存。
存储与检索：记忆基于文件系统；默认落在当前工作区的 .workbuddy/memory/ 目录，隐私由本机与仓库权限控制，可直接用编辑器查看或修改。检索侧支持关键词匹配，并声明使用 Qwen3-Rerank 做精排；条目侧用 YAML 管理元数据，便于分类与过滤。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。在 SkillHub 上安装时，需把包装到当前 Agent 能识别的 skills 目录，否则 Agent 不会加载。
1. 准备 SkillHub CLI¶
先确认是否已安装 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装 memory-skill¶
将坐标 @user_4005c3e1/memory-skill 安装到当前环境的 skills 目录。<skills 目录> 需替换为实际路径，例如 Cursor 常用 ~/.cursor/skills/：
skillhub install @user_4005c3e1/memory-skill --dir ~/.cursor/skills/
官方页面也支持把下面提示交给 Agent，由其按 SkillHub 安装说明 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_4005c3e1/memory-skill`。
其他客户端的常见 skills 路径（摘自 SkillHub 安装文档，按你实际使用的工具选用）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/ - workbuddy：
~/.workbuddy/skills/
安装后按所用 Agent 的要求重启或刷新 Skill 列表，使 memory-skill 生效。具体触发词、子命令与目录结构以包内 SKILL.md 为准。
3. 记忆数据目录¶
运行时产生的记忆文件写入工作区 .workbuddy/memory/（注意路径相对当前项目根）。若使用 Cursor 等客户端但记忆目录仍落在 workbuddy 约定下，需确认工作区与 Agent 配置一致，避免「Skill 已装但找不到记忆文件」的错位。
典型用法¶
公开页面未提供逐步复制的命令示例；可复现的流程可按官方能力描述理解如下。
- 启用 Skill 后，在对话中让 Agent 把需要长期保留的信息写入对应类别（例如项目背景、错误教训、决策记录）。Agent 应依据 SKILL.md 选择子目录与 YAML 字段。
- 新会话开始时，让 Agent 根据当前任务从
.workbuddy/memory/检索相关记忆：先关键词匹配，再经 Qwen3-Rerank 精排，将高相关片段注入上下文。 - 人工维护：需要纠正或删除过时记忆时，直接编辑该目录下的文件；YAML 元数据便于你批量查看类别与时间信息。
若需确认写入模板、检索参数或精排开关，请在安装完成后打开 ~/.cursor/skills/（或你指定的 --dir）下 memory-skill 包内的 SKILL.md 对照执行。
适用场景与注意¶
适合谁
- 长期维护同一仓库或产品，希望 Agent 记住偏好、架构决策与历史教训的开发者。
- 需要可审计、可版本管理的「Agent 记忆」，而不是不可见的向量库黑箱。
- 使用 workbuddy 或已按 SkillHub 文档配置 skills 目录的 Agent 用户。
限制与注意
- 记忆体量随项目增长，应定期整理
.workbuddy/memory/，避免检索噪音。 - 多机器协作时，若记忆只在本机工作区，需通过 git 或其他同步方式显式共享（是否纳入版本库由团队规范决定）。
- SkillHub 统计（截至页面抓取）：评分 100000，下载 1377，安装 18；社区 Skill，维护节奏以发布者为准。
- 精排能力涉及 Qwen3-Rerank，环境差异可能导致召回质量不同；以实际 SKILL.md 配置为准。
结尾¶
memory-skill 把 Agent 长期记忆落到本地文件：分类清晰、可检索、可编辑，适合把「会话里的口头约定」沉淀成项目资产。安装与坐标以 SkillHub 为准。
- SkillHub 页面：https://www.skillhub.cn/skills/user_4005c3e1/memory-skill
- API 入口（页面链接）：https://api.skillhub.cn/user_4005c3e1/memory-skill
