37 份技能说明书 27 万 token：按需加载撕掉七成，常驻描述只占 3.16%
用 Qwen2.5 官方分词器对本机 37 个技能的 SKILL.md 做精确计数（非按字数估算，整库平均 1.92 字符/token）。全量 526,270 字符 / 273,324 token，相当于 219 篇 2000 字公众号稿（单篇约 1,245 token）。结构拆分：frontmatter 共 11,482 token 占 4.20%，其中 description 一项 8,646 token 占 3.16%——这是唯一「每次开新会话都要付」的常驻成本；正文 261,813 token 占 95.77%，是按需加载的。单技能差距悬殊：最大 wxmp-virtualpay-cloud 51,060 token（占全库 19.1%，正文 49,964 token / 99,266 汉字，比 32K 窗口还长三倍），正文 token 中位数仅 2,777，最大是最小侧的 18 倍。模拟 6 个真实任务按 description 路由：平均命中 8.0/37 个，平均载入 77,444 token = 全库正文的 29.6%（省 70.4%），杠杆 3.4 倍。窗口占用：8K 窗口全量需 33.0 倍、按需均值 10.5 倍；32K 窗口全量 8.25 倍、按需 2.63 倍。目录体量 6.18 MB / 266 文件 / 78 个 md，单技能文件数 1–69（中位 3），文件数与 token 量不成正比。
技能库SKILL.md上下文工程token按需加载Agent上下文窗口描述分词器成本结构这条适用于
- 本地有一批以 SKILL.md 为入口的技能/工具说明书目录
- 需要与目标模型匹配的分词器（本文用 Qwen2.5 官方 tokenizer.json）
- 能读到每个文件的 frontmatter 与正文分界
版本指纹
Qwen2.5-14B-Instruct tokenizer.json（本地加载）；37 个 SKILL.md，2026-10-20 快照
具体做法
环境：本机 C:\Users\<user>\.workbuddy\skills 目录下 37 个含 SKILL.md 的技能，2026-10-20。分词器 = Qwen2.5-14B-Instruct 官方 tokenizer.json（本地加载，非远程调用）。【总量】
· 37 个技能 / 526,270 字符 / 273,324 token / 平均 1.92 字符·token⁻¹
· frontmatter 11,482 token = 4.20%
· description 8,646 token = 3.16%（常驻）
· 正文 261,813 token = 95.77%（按需）【单技能正文 token Top5】
· wxmp-virtualpay-cloud 49,964（占全库 19.1%，正文 99,266 字，文件 169,752 B）
· gzh-article-to-shipin-hao 35,389（13.5%，正文 57,384 字）
· wxmp-wxml-field-audit 20,838（8.0%）
· dsh-local-maintain 17,569（6.7%）
· wechat-mp-mia-pipeline 14,682（5.6%）
· 正文 token 中位数 2,777；全库 total token 中位数 2,926；最大单技能 51,060
【description 分布】
· token 中位 134 / 最长 1,166（wxmp-wxml-field-audit）/ 字符中位 222
· 占自身全文比例最高 20.03%（uumit-cruise，正文仅 2,543 token）
【按需加载模拟（6 个任务，按 description 中文关键词命中）】
· 公众号出稿 → 命中 9 个 → 123,719 token（47.25%）
· 长文改口播 → 9 个 → 78,595（30.02%）
· 查跑分数据 → 9 个 → 57,007（21.77%）
· 小程序虚拟支付 → 8 个 → 102,562（39.17%）
· 远程看显卡 → 9 个 → 55,430（21.17%）
· SRT 白板动画 → 4 个 → 47,353（18.09%）
· 平均命中 8.0 个 / 平均载入 77,444 token = 29.6%（省 70.4%）【结构与窗口】
· 目录 6.18 MB / 266 文件 / 78 个 md；单技能文件数 1–69，中位 3
· 跨技能重复句仅 3 条、多出 323 token（0.12%）
· 8K 窗口：全量 33.0 倍 / 按需 10.5 倍；32K 窗口：8.25 倍 / 2.63 倍
· 对照：一篇 2000 字公众号稿 ≈ 1,245 token，全库 ≈ 219 篇
本结论为本机实测（2026-10-20），对象是本机 37 个技能的 SKILL.md 说明书，不含脚本、模板与参考文档。token 数由 Qwen2.5 官方分词器精确计数，不同模型分词器结果会不同（同一文本在不同分词器上可差 10% 以上）。6 个任务的路由结果是按中文关键词模拟的，不是真实 Agent 决策日志，因此只能说明「筛得掉」，不能说明「筛得准」。常驻成本只统计了 description 一项，未计入系统提示、工具 schema 等其他常驻开销。