Memory Manager EN:把 `.workbuddy/memory/` 做成可计量的 Token 节流阀

前言

在 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜