前言¶
在 WorkBuddy 一类 Agent 里,每次会话往往会把 .workbuddy/memory/ 下的记忆文件整段塞进上下文。文件越大,占用的 Token 越多,响应更慢、成本更高。手工删文件、凭感觉裁剪,很难对齐真实计费粒度,也缺少「按当前任务只加载相关片段」的机制。
下面介绍 SkillHub 上的 Memory Manager EN:围绕「让进入上下文的记忆更小、更准、更便宜」设计,把记忆目录当作可管理的 Token 预算对象,而不是普通文件夹。
这是什么¶
Memory Manager EN 的定位是 AI memory accelerator / Token throttle valve(记忆加速与 Token 节流),目标目录是 .workbuddy/memory/。
SkillHub 页面(@indiv-aakook/memory-manager-en)用一句话概括问题:会话会加载该目录;文件越大 → Token 越多 → 越贵越慢;省 Token 的本质是让进入上下文的记忆更紧凑、更精准。该 Skill 按「节流阀」思路组织能力。
发布与索引信息(以 SkillHub 展示为准):
- 官方入口:https://api.skillhub.cn/user_98283d0f/memory-manager-en
- 技能页:https://skillhub.cn/skills/indiv-aakook/memory-manager-en(页面标注版本 v4.0.6)
- 分类:ai-agent;下载 617 次;平台评分指标 99677(SkillHub 站内展示,非五星制)
维护方在 SkillHub 上对应账号 user_98283d0f(页面简介为「GEO爱好者」)。
核心功能¶
以下能力来自该 Skill 的公开简介说明;安装后具体子命令以随 Skill 下发的 SKILL.md 为准。
Token 计量与预算¶
- 使用 tiktoken 做真实 Token 计量(简介称 V3.9 起为核心能力之一;SkillHub 列表版本为 v4.0.6)。
- 硬预算门:超预算时可自动压缩(over-budget auto-compaction)。
- Throttle:一键预算压缩。
- 三色预算告警,并参考 7 日平均用量。
- 界面与输出中的 Token 数字均标注为 estimated(估算),避免与账单完全等同的误解。
按任务相关性加载¶
- 支持
--query/--tags:零依赖的 CJK 字符二元组 + 关键词/标签相关性排序;可选 embedding 后端。 - 目标是在不把整库记忆灌进上下文的前提下,加载与当前任务更相关的片段(task-relevance loading)。
自动化与可编程输出¶
- 破坏性操作提供
--force,便于脚本与 CI 式流程。 - 每条命令支持
--json,方便 Agent 或其它工具解析结果。
安全与自检¶
- 内置 self-test,包含对 prompt-injection、path-traversal 等风险的检查说明(防护向能力)。
性能¶
- 并行摘要生成(线程池)。
- 带排名的磁盘签名缓存、读路径短路、回退 LRU 缓存。
体验与其它修复¶
- 24 个短别名、交互式进度、可读的大小标签。
- 缺陷修复(简介列举):
prompt-get在模板缺失时不再崩溃;backup支持传入 workspace 参数。
安装与启用¶
SkillHub 推荐让 Agent 按安装文档拉取该 Skill,标识为 @indiv-aakook/memory-manager-en。
1、安装 SkillHub CLI(若尚未安装)¶
command -v skillhub && skillhub --version
未安装时可执行(完整安装,含默认 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 Manager EN¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认落在 ./skills/ 可能不会被识别。
skillhub install @indiv-aakook/memory-manager-en --dir <你的 skills 目录>
常见路径(摘自 SkillHub 安装文档,按你实际客户端选择):
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| workbuddy | ~/.workbuddy/skills/ |
安装完成后按所用客户端要求重启或刷新 Skill 列表。更完整的优先源策略见:https://skillhub.cn/install/skillhub.md
典型用法¶
该 Skill 通过自然语言意图触发(在支持 Skill 的 Agent 中启用后,用对话下达任务即可)。简介中给出的典型说法包括:
- Token / 预算:
memory manager、token check、throttle、token trend - 加载与检索:
relevance load、smart load、memory search、memory rank - 维护与分析:
cache clean、cache reminder、dedup、backup memory、memory analyze、memory report、diagnose - 提示词模板:
prompt template
需要脚本集成时,在对应子命令上附加 --json;确认覆盖类操作时按提示使用 --force。按任务裁剪记忆时,使用 --query 或 --tags 表达当前任务或标签集。
具体命令名与参数组合以安装包内 SKILL.md 为准;本文不臆造未在公开资料出现的 CLI 名称。
适用场景与注意¶
适合:
- 长期使用 WorkBuddy /
.workbuddy/memory/的开发者,需要控制上下文 Token、做预算告警或趋势查看。 - 希望「按查询/标签 relevance load」而不是全量加载记忆的场景。
- 需要备份记忆、去重、缓存清理、记忆分析报告、诊断类操作,且希望输出可被程序消费(
--json)。
不适合(Skill 自述边界):
- 通用文件操作、代码分析、系统清理、文档编辑等——应使用对应工具,而非本 Skill。
注意:
- Token 显示为 estimated,计费仍以模型侧账单为准。
- 自动压缩、带
--force的操作可能改写或删除记忆内容,执行前确认备份(Skill 提供backup memory相关能力)。 - 可选 embedding 后端若启用,需自行满足其依赖与网络/密钥配置(细节见 Skill 文档)。
结尾¶
Memory Manager EN 把 .workbuddy/memory/ 从「越积越大」的静态目录,拉成可计量、可节流、可按任务 relevance 加载的对象,并兼顾 JSON 输出与安全自检,适合把它当作 Agent 记忆层的运维 Skill。
官方地址:https://api.skillhub.cn/user_98283d0f/memory-manager-en
SkillHub 技能页:https://skillhub.cn/skills/indiv-aakook/memory-manager-en