前言¶
做智能体流水线时，一个常见问题是：助手能连续干活，但人不能直接走开。原因在于编排侧和执行侧之间缺少一份明确约定：dispatch spec 应该包含什么，哪个阶段使用哪一档模型，谁可以提交 git，验证到底以什么为证据。
hermes-dsh-collab 就是为这个缺口提供的技能包。它把 DeepSeek Harness（DSH）挂进 Hermes 流水线，提供 dispatch-spec 模板、模型分层路由、质量门和 git single-writer 规则，形成一个可安装、可复用的 skill pack。
这是什么¶
hermes-dsh-collab 是一个 DSH 插件，仓库为 Cavan-Ou/hermes-dsh-collab，许可证为 MIT。
它的一句话定位是：把 DSH 接入 Hermes 流水线，覆盖 dispatch spec、模型分层路由、质量门和 git 单写者规则。
它解决的问题可以概括为：
1、让 dispatch、执行、验证形成自动化链路。
2、让质量门由编排侧持有，不把 self-reports 当作证据。
3、用明确规则约束模型选择、提交权限和写回方式。
4、把已踩过的坑整理成有收据的 pitfall 列表。
核心能力¶
下面介绍该技能包已明确包含的能力。
自动化 dispatch、执行和验证¶
技能包描述的能力包括 automated dispatch, execution, and verification。在实际使用里，它把编排侧生成的任务、DSH 的执行过程、以及后续验证放进同一条流程。
质量门由编排侧持有¶
该技能包强调 Quality gates owned by the orchestrator，并且明确 Self-reports are not evidence.。也就是说，执行侧自己的完成说明不能直接作为通过依据，验证仍由编排侧完成。
模型分层路由¶
技能包包含 Model-tier routing，用于在不同任务阶段选择对应模型档位。
Spec 3 iron rules¶
技能包包含 Spec 3 iron rules，用于约束 dispatch spec 的生成质量。缺少必要约束的 spec，不应直接进入执行。
Git single-writer¶
技能包包含 Git single-writer 规则。按该规则，执行器不应直接执行 git commit；提交行为由编排侧控制，以避免执行侧越权改写仓库状态。
通过 cwd 写回¶
技能包支持 Write-back via cwd。常见调用方式是先进入项目目录，再运行 DSH headless profile 任务：
cd <project> && dsh --profile headless "task"
这种方式让结果直接写回当前工作目录，而不是依赖额外的临时镜像或 patch 交接。
Pitfalls with receipts¶
技能包还包含 Pitfalls with receipts，把已知陷阱整理成可追溯的列表。已核实的注意事项包括：
patch config替换整个 section，而不是 deep-merge。qwen拒绝reasoning: max。- vision patches 不会改变主模型。
- 旧的后端进程会使绿色测试结果失效。
安装与启用¶
通过 DSH plugin 安装¶
官方安装命令如下：
dsh plugin --profile headless add github:Cavan-Ou/hermes-dsh-collab
这条命令会按 headless profile 安装该插件。
直接复制技能包¶
也可以把技能包复制到 DSH skills 目录：
git clone https://github.com/Cavan-Ou/hermes-dsh-collab
cp -r skills/hermes-dsh-collab "$DSH_HOME/skills/" # default: ~/.dsh/skills/
$DSH_HOME/skills/ 的默认路径是 ~/.dsh/skills/。复制后，新的 DSH 会话应能在 skills 列表中看到 hermes-dsh-collab。
启用后如何验证¶
下面给出三个检查项。
1、打开新的 DSH 会话，确认 skills 列表中出现了 hermes-dsh-collab。
2、输入类似 write me a dispatch spec 的请求，确认技能包能按场景触发。
3、询问执行器是否可以 git commit，预期回答是 no，并解释原因来自 single-writer rule。
典型用法¶
安装完成后，可以先在一个具体项目里做 headless 任务：
cd <project> && dsh --profile headless "task"
这一步把 DSH 限定在当前项目目录中运行，适合配合 Write-back via cwd 的方式。
在会话里可以围绕 dispatch spec 提问：
write me a dispatch spec
也可以围绕提交权限提问：
can the executor git commit?
按 Git single-writer 规则，执行器不应被允许直接提交。
适用场景与注意¶
依赖环境¶
该技能包依赖：
- DSH 0.1.x，headless profile。
- 任意 orchestrator agent。
- 构建和测试使用 Hermes。
因此它更适合已经使用 DSH headless profile，并且有编排侧代理的场景。
权限与许可证¶
该插件会在当前 DSH 进程权限下运行。安装前应先检查源码、行为边界和许可证。该仓库声明许可证为 MIT。
路径可移植性¶
技能包中的 sources of truth 可能指向 workspace 特定路径，例如：
~/.dsh/profiles/headless/*.patch.yml
规则本身是可移植的，但路径需要按实际 workspace 调整。
质量判断¶
该技能包明确不把 self-reports 当作证据。质量门、执行结果和验证结论仍需要由编排侧负责确认。
链接¶
仓库地址：
https://github.com/Cavan-Ou/hermes-dsh-collab
如果你使用的是独立插件目录，也可以按 hermes-dsh-collab 检索。该目录不是 DeepSeek 或幻方官方应用商店。
