前言¶
做智能體流水線時，一個常見問題是：助手能連續幹活，但人不能直接走開。原因在於編排側和執行側之間缺少一份明確約定：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 或幻方官方應用商店。
