前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。當處理複雜任務時，直接在主 Agent 內部處理會變得雜亂無章，而盲目使用子 Agent 又可能導致資源浪費。我們需要一套機制來回答三個問題：何時該派、怎麼派、以及回來怎麼驗收。
dsh-subagent-delegation 插件就是爲了解決這些問題而設計。它附帶了一套技能，用於指導主 Agent 何時將工作委託給子 Agent、如何並行分發，以及如何驗證返回結果。
核心定位¶
這是一個 DSH 插件，附帶一套技能，負責指導主 Agent 何時將工作委託給子 Agent，如何並行分發，以及如何驗證返回結果。插件由 gezi-wen 維護。
核心功能¶
何時該派¶
插件內置了一套決策邏輯，用於判斷是否應該將任務委託出去。主要依據是決策三問：
- 要翻 5+ 個文件
- 要多次搜索調研
- 有 2+ 個互不依賴的子項
此外，還存在「紅牌警示」：當遇到 5 個文件的「簡單任務」時，也應當觸發委託，避免主 Agent 負載過重。
派發形態¶
DSH 的子 Agent 沒有內置的 Explore 或 general-purpose 類型。子 Agent 的形態完全依賴 Prompt 承載。開發者需要根據任務需求，編寫只讀探索、通用分析、方案設計、獨立審查等不同模式的 Prompt。
並行與後臺¶
在同一輪消息裏發送多個 subagent 調用，即可讓它們並行執行。默認情況下，subagent 進程進入後臺運行。如果任務需要看見當前對話的上下文，應使用 subagent_fork。
驗收流程¶
不要盲信子 Agent 的總結。驗收的核心在於覈對「實際文件變更」和子 Agent 給出的「證據鏈」，確保結果與預期一致。
安裝與啓用¶
使用官方命令安裝插件：
dsh plugin --profile web add dsh-subagent-delegation
安裝時，包內的 skills/ 目錄會被註冊爲一個技能根，隨插件進入 Agent 的技能目錄。
機制說明¶
該插件通過 cordis.patch.yml 機制進行集成。其機制與 DSH 自帶 agent preset 裝載技能是一致的。
在 cordis.patch.yml 中，通過 !!js 裏的 baseUrl 解析到本包，因此路徑跟隨安裝位置走。開發者需要確保 customSkillDirs 指向 skills/ 目錄。
注意事項¶
- DSH 的子 Agent 沒有 Explore / general-purpose 這類內置類型，形態只能靠 prompt 承載。
- 不要盲目信任子 Agent 的總結，必須覈對實際文件變更和它給出的證據鏈。
結語¶
dsh-subagent-delegation 提供了一套清晰的委託與驗收流程，幫助開發者構建更高效、可控的 DSH 工作流。
