前言¶
長對話、多輪 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