前言¶
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 工作流。