技能目录懒加载 boomzikazita/dsh-skill-lazy

dsh-skill-lazy

为 DeepSeek Harness（DSH）提供的惰性技能目录加载。通过仅注入技能名称 + 一行摘要而非完整目录，在每个会话中节省 token，并按需通过 skill_search 查找完整描述。

为什么

默认情况下，DSH 会将完整的技能目录——每个已安装技能的名称加上最多 500 个字符的描述——注入到每个新会话的上下文中。安装了几十个技能后，这大约会消耗每个会话约 3K token 的持久上下文，即使模型很少触及其中大部分技能。

dsh-skill-lazy 用紧凑目录取代了完整的转储：仅技能名称和一行摘要（默认 ≤ 40 个字符）。完整描述只需一次 skill_search 调用即可获取，并且仅在真正需要时才获取。

工作原理

第一遍：紧凑目录注入

- 在每个 agent 预步骤中，插件会将官方的 skill-catalog 消息重写为一个 块，其中每个技能以 name: one-line summary 的形式出现。
- 条目按调用频率（最常使用的在前）排序，频率相同时按字母顺序排列。
- 目录消息底层的 source.entries 保持不变，因此 harness 自身的摘要/去重逻辑不受影响。

按需：skill_search

- 注册一个 skill_search 工具，它按关键词查询完整目录，并返回按 MECE 领域（相互独立的分组，完全穷尽的覆盖）分组的结果，每组包含其完整描述、使用次数，以及一份标记空领域或弱领域的领域覆盖报告。
- 查询评分涵盖精确名称匹配、描述子串匹配、分词关键词以及中文 2-gram 重叠。

使用跟踪

- 一个 tools/post-execute 钩子会将每次 skill 工具调用记录到 usage.json（运行时数据——见 .gitignore）。累积的计数驱动目录排序。
- 可选地，可以在用户消息之后立即注入一个主动匹配提示（相关性 ≥ 阈值的前 3 个技能）。

skill_mece_check

- 一个 skill_mece_check 工具在创建或评估技能之前运行：它检查相互独立（与每个现有技能的关键词重叠，并给出重叠比例）和完全穷尽（领域覆盖矩阵，标记空领域/弱领域），然后建议是创建新技能还是扩展现有技能。

cost_audit

- 一个 cost_audit token 成本看门狗（于 2026-08-21 添加）统计每个插件工具 description 和每个技能目录 description 的字符/token 成本，与预算进行比较（工具描述默认 1500 token；技能目录默认 800 token），并标记任何超出预算的内容以供精简或折叠。
- 单个工具描述超过 700 个字符的会被标记为需要精简——细节应放在技能自己的文档中，而不是注入的描述中。

安装

dsh plugin --profile web add github:boomzikazita/dsh-skill-lazy

该插件通过其 bundle 补丁（cordis.patch.yml）挂载，该补丁将 skill-lazy bundle 添加到配置文件的 dsh.profile.bundles 中。

配置

| 选项 | 默认值 | 描述 |
| catalogDescriptionMaxLength | 40 | 紧凑目录中每个技能单行摘要的最大字符数。 |
| topK | 6 | skill_search 返回的每个领域组的最大命中数（限制在 1–20 之间）。 |
| sortByUsage | true | 按记录的调用频率对目录条目排序（回退：按字母顺序）。 |
| matchThreshold | 6 | 主动匹配提示的最低相关性分数。 |

带有自定义配置的 bundle 补丁示例：

- insert:
- id: skill-lazy
name: 'dsh-skill-lazy'
config:
catalogDescriptionMaxLength: 40
topK: 6

要求

- 带有 @deepseek-ai/dsh-tools ≥ 0.1.0-rc.6 的 DeepSeek Harness（对等依赖 — 它并未被打包）。

许可证

MIT © 2026 boomzikazita。参见 LICENSE。