前言¶
长对话、多轮 Agent 任务里，上下文会不断堆叠：重复说明、历史摘要、工具输出片段。这些内容往往占掉大量 token，计费上升，窗口也更早触顶。常见做法是手动删历史、缩短 system prompt，或换更小上下文模型——都费时，且容易误删关键信息。
下面介绍 SkillHub 社区技能 Token Optimizer（坐标 @user_5accef42/tokenoptimizer）：在对话侧自动识别并压缩冗余表述，官方说明为在不影响质量的前提下节约 token 使用量。
这是什么¶
Token Optimizer 是分类为 ai-agent 的自动化 Skill，当前版本 1.0.1，来源为 community，由发布者 user_5accef42 维护。标签标明 requires_api_key=false，安装后无需额外 API Key。
定位可以概括为：挂载在 Agent 对话流程上的 token 优化层——智能压缩 AI 对话中的冗余内容，而不是让你每次手动裁剪上下文。
核心功能¶
依据 SkillHub 页面与官方简介，已核实的能力如下：
- 智能压缩冗余：针对对话里重复、可合并的表述做压缩，目标是降低 token 消耗。
- 质量前提：官方表述为「在不影响质量的前提下」节约用量；具体压缩策略以 Skill 内
SKILL.md为准。 - 两种触发方式：直接加载该 Skill；或在对话中加入关键词 「token优化」。
- 持续生效：一次触发后持续生效，无需每轮重复开启。
SkillHub 上该技能评分 100000，下载 2834 次，安装 67 次（数据取自 SkillHub 页面展示）。
安装与启用¶
官方推荐通过 SkillHub 安装文档完成 CLI 与技能安装。页面给出的安装提示为：根据 SkillHub 安装说明，安装 @user_5accef42/tokenoptimizer。
1. 检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按安装文档执行完整安装（示例命令来自官方文档）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2. 安装 Token Optimizer 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；官方文档强调未指定时默认装到 ./skills/，可能不会被 Agent 加载。
skillhub install @user_5accef42/tokenoptimizer --dir <skills 目录>
各客户端常见路径（摘自 SkillHub 安装文档，按你实际环境选择）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将官方页面上的安装提示词发给当前 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装；效果等价于上述流程，具体步骤由 Agent 按文档执行。
3. 启用¶
安装并加载 Skill 后，在对话中说 「token优化」 即可触发；若 Agent 已默认加载该 Skill，则按 Skill 规则自动参与对话处理。
典型用法¶
方式一：加载 Skill 后正常对话
在 Cursor、Claude Code 等支持 Skills 的环境中安装并启用 @user_5accef42/tokenoptimizer，继续你的编码或 Agent 任务。Skill 在后台参与上下文处理，无需每轮重复配置。
方式二：关键词触发
若尚未默认加载，可在任意一轮输入中包含：
token优化
按官方说明，触发一次后即可持续生效。
方式三：通过 AI 代为安装
向 Agent 发送 SkillHub 页面提供的提示（大意如下），由 Agent 读取安装文档并安装坐标包：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5accef42/tokenoptimizer。
适用场景与注意¶
适合谁
- 长会话、多工具调用的 Agent 开发者，希望降低上下文 token 占用。
- 使用按 token 计费或上下文窗口有限的模型，需要控制成本与长度。
- 不想在每轮对话里手动删历史的团队或个人。
限制与注意
- 压缩逻辑由 Skill 定义，对极短对话或本身已精简的上下文，收益可能不明显。
- 「不影响质量」是官方目标表述；对强依赖原文逐字引用的任务（合规留痕、精确 diff 对照等），建议在关键轮次自行核对输出是否仍完整。
- 安装路径必须与当前 Agent 的 skills 目录一致，否则技能不会被识别；部分环境安装后仍需重启或重载 Agent。
- 本 Skill 不需要 API Key，但底层模型调用仍走你已有的模型配置与计费。
结尾¶
Token Optimizer 把「删冗余、省 token」从手工操作变成可挂载的 Skill：加载或说一句「token优化」即可持续生效，适合 ai-agent 类长对话场景。详情与安装入口见 SkillHub：
- 技能页：https://www.skillhub.cn/skills/user_5accef42/tokenoptimizer
- API 坐标页：https://api.skillhub.cn/user_5accef42/tokenoptimizer
