DeepSeek Harness Skills 怎么用？DSH plugin 的 skill 工具、目录与调用

DeepSeek Harness 的 skill 是可选加载的指令而非会话事件：各提供方把本地或随包 skill 注册进 ctx.skills，注册表在宿主层与各 scope 层之间合并目录，面向模型的 skill 工具负责按 cwd 加载与调用它们（来源）。 存放位置与优先级见《DeepSeek Harness Skills 放哪能被发现》，本篇讲它怎么被调用与合并。

DeepSeek Harness 的 skill 是什么

skill 是可选的指令，不是会话事件，因此它的词汇定义不在 core 里；需要时由模型按需取用，而不是每轮都塞进上下文（来源）。 关键含义：

1. 按需加载 — skill 提供方注册后，是否加载由调用时决定。预期：不用它就不占模型的注意力。
2. 不是会话历史的一部分 — 它与会话事件走不同通道。预期：查会话历史时不会把 skill 内容当事件看到。
3. 可以来自多个来源 — 本地目录、随包、进程内等都能贡献。预期：一个部署里可能同时有多套 skill 来源。

想在社区里找带 skill 的插件，可以先到 DSH Plugin Hub 浏览。

DeepSeek Harness 的 skill 谁提供：ctx.skills 与各提供方

skill 能力族包含 Service Definition、若干 Service Provider 和一个 Consumer：Definition 是 dsh-skill（ctx.skills），Consumer 是 dsh-tool-skill（面向模型的 skill 工具）（来源）。 逐个认识：

1. dsh-skill（Definition） — 定义 ctx.skills 与相关词汇。预期：它是所有提供方注册的落脚点。
2. dsh-skill-filesystem（本地提供方） — 从文件系统目录贡献 skill。预期：你本地目录里的 skill 由它发现。
3. dsh-skill-badge、dsh-skill-office（随包提供方） — 随包附带 skill。预期：装了对应包就有对应 skill，不用自己写。
4. sandbox-windows-acl（诊断提供方） — 提供 Windows ACL 诊断类 skill。预期：Windows 平台排查时有用。
5. dsh-tool-skill（Consumer） — 拥有初始目录与替换目录，并暴露面向模型的 skill 工具。预期：模型通过它拿 skill。

SkillProvider 在 apply() 期间同步注册，远程初始化、鉴权与发现在 list() 里异步完成；SkillProviderObservation 允许提供方声明本次发现是否权威（complete），用以区分「可缓存的完整结果」与「来自不完整发现的部分结果」。

DeepSeek Harness 的 skill 目录怎么合并：宿主层与 scope 层

注册表采用「宿主 + 各 scope」的叠加结构，读时在宿主层与该 scope 的链上合并；最窄层的条目直接赢得同名 skill，rank 顺序只在同一层内决定优先级（来源）。 理解方式：

1. 两层结构 — 宿主层与 scope 层各自持有目录，读取时沿 scope 链合并。预期：更贴近当前工作的层覆盖更外层的同名 skill。
2. 同层比 rank — 在同一个层里，按 rank、提供方顺序与本地顺序的次序确定优先级。预期：层内冲突有确定规则，不是随机。
3. 按名去重 — 同名 skill 以最窄层为准。预期：想临时覆盖某个 skill，在更窄的 scope 里放一个同名版本即可。
4. 具体目录与优先级数字 — 六个本地来源（project-dsh、project-agents、custom、user-dsh、user-agents、bundled）与其 rank 见《DeepSeek Harness Skills 放哪能被发现》。

DeepSeek Harness 的 skill 怎么被调用与刷新

模型通过 skill 工具按 cwd 等查找选项调用 skill；提供方在内容变动时发出不带 diff 的 skills/change 失效事件，消费者需自行重新获取 snapshot()（来源）。 使用要点：

1. 带 cwd 调用 — 查找选项里 cwd 用来选择工作区相关的 skill。预期：同一 skill 名在不同工作区可能解析到不同结果。
2. provider 的 get() 加载正文 — 对已列出的候选，提供方用 get(candidate, options) 取完整内容；不再可加载时返回 undefined。预期：候选可能过期，要处理取不到的情况。
3. 改动走失效而非增量 — skills/change 事件不带 diff，invalidate() 会清除已完成目录并通知消费者。预期：收到变更后重新拉取，别指望事件里带着变化内容。
4. 失败定位到提供方 — 某个提供方 list() 被拒绝时会记录日志，并从完整观察中剔除该提供方的结果；格式错误的候选会快速失败。预期：一个来源出错不会污染整张 skill 列表。

注意事项与常见问题

1. skill ≠ 会话事件：查会话历史看不到 skill 内容，两者别再混淆。
2. 同名看层不看 rank 跨层：跨层覆盖由「最窄层胜出」决定，rank 只在同层生效。
3. complete: false 要谨慎缓存：不完整发现的结果可能只是部分候选。
4. 改了要重新拉取：失效事件不带 diff，消费者自己重取快照。
5. skill 也是插件贡献的能力：找不到想要的，去 DSH Plugin Hub 看看社区插件，或参考《DeepSeek Harness 内置工具有哪些》。

来源：Skills（官方文档）、工具 Schema 目录（官方文档）