前言¶
在 DSH 里手工开子会话派活，常见瓶颈往往不是「模型不够强」，而是三件事缺少固定做法：该用哪档模型、该注入什么人设、任务书写到什么程度才算可执行。编排者若每次都临时决定，成本会落在重复沟通和事后对不上验收标准上。oh-my-claudecode 等实践已经表明：按角色复杂度分配模型，比全员上最贵档更合理。dsh-agents 把角色目录、档位路由和任务书合成收进一次工具调用，让派活可审、可核对、可落在标准 DSH 会话里。
这是什么¶
dsh-agents 是社区维护的 DSH 插件（GitHub：wangyuanchuan2022/dsh-agents，当前 package 版本 0.1.0，MIT 许可）。维护者为 wangyuanchuan2022。插件向宿主注册 agent_roles、agent_taskbook、agent_spawn 三个工具：23 个专职角色按 build / review / domain 三条泳道组织，每个角色钉在三档模型路由（LOW / MEDIUM / HIGH）之一；一次 agent_spawn 即完成档位解析、人格注入、八节任务书合成，并创建可接管的标准 DSH 子会话。另含 25 个工作流技能目录（skills/ 下 25 个 SKILL.md）用于端到端编排，以及内置 advisor 等机制（详见仓库 README）。
社区目录页：https://www.skillhub.cn/plugins/wangyuanchuan2022/dsh-agents（独立站点，与 DeepSeek / 幻方无官方从属关系）。
核心功能¶
角色与档位¶
合计 23 个角色：HIGH 档 11、MEDIUM 档 10、LOW 档 2。其中 19 个角色移植自 oh-my-claudecode，4 个为插件新建（rag-reviewer、silent-failure-hunter、spec-miner、harness-optimizer）。档位语义在 README 中约定为：LOW 偏窄而快的检索与文档；MEDIUM 偏实现、调试、测试与设计；HIGH 偏需求分析、规划、架构与长链推理。
九个子角色在上游标注为只读（disallowedTools: Write, Edit），任务书中写成只读顾问条款；插件说明中同时注明这只是文字约束，执行边界仍取决于宿主与会话权限（见仓库「已知限制」）。
档位映射分两层：cordis.patch.yml 的出厂默认与用户层覆盖（设置页「Agents 三档模型路由」或 agent_roles action=set）。解析优先级为：调用期显式 tier / provider / model → roleOverrides → settings → cordis 基底 → 内置默认表。未知档位、未知角色或非法配置会抛错，不静默兜底。
三个工具¶
| 工具 | 作用 |
|---|---|
agent_roles |
角色目录、单角色详情、档位路由表体检；支持 list / show / tiers / set / reset |
agent_taskbook |
只合成任务书，不创建会话；含派活前置三问与本次路由解析结果 |
agent_spawn |
一步派活；dryRun=true 仅返回路由与任务书；越档参数会记入返回以便审计 |
会话生命周期中的 wake / status / list / rename 由宿主 de_session 负责，本插件只负责创建会话。
任务书与会话产出¶
派活首条消息为八节任务书：角色卡、职责与边界、人格细则（personas/<id>.md）、本次任务、交付与验收（含落盘路径与硬性完成标准）、澄清模式、汇报与回收、Claude Code → DSH 工具映射。评审类角色可附加「上下文隔离契约」；对下发材料有机检泄漏告警（isolationLeaks）。
默认产出路径为 <cwd>/agent-out/<角色id>-<yyyyMMdd-HHmm>.md，可用 evidencePath 覆盖。
工作流技能与其它能力¶
README 列出 25 件工作流技能，分入口、流水线、协作、方法论、顾问等组；例如 agent-workflow-router 作总入口，agent-autopilot / agent-feature / agent-bugfix / agent-review-squad 等串联 23 角色。另有 11 份按语言或专项路由的评审清单，以及确定性机检工具 crgate 与 publish-scan。内置 advisor 在每 turn 后被动评审主会话可见消息，不占上述三个 agent 工具位。
环境要求¶
- DSH 需提供
tools服务（工具经ctx.tools.register注册）；settings/llm/workspaceRegistry/agentPresets为可选，缺失时插件仍可加载但部分能力降级。 - Node.js 需支持 ESM；仓库开发环境为 Node 24。
- 新增 bundle 后需重启 DSH：宿主引导图在启动时生成，运行中新增的插件不会被加载。
安装与启用¶
安装命令以仓库 README 为准：
# 本地路径安装（推荐先 git clone 到本地）
dsh plugin --profile <profile-name> add /path/to/dsh-agents
# 或直接从 git 安装
dsh plugin --profile <profile-name> add https://github.com/wangyuanchuan2022/dsh-agents
宿主契约与既有 DSH 插件一致：package.json 的 dsh.bundle.patch 指向 cordis.patch.yml，lib/index.js 导出 name / inject / apply。安装后不要在 profile patch 里重复插入同一插件 id，否则 loader 可能失败。人格正文在 personas/；可用 tools/install-personas.mjs 批量安装到 DSH（默认跳过已有自定义版本的角色）。
插件以当前 DSH 进程权限运行；安装前应自行审阅源码与 MIT 许可证，确认角色与任务书是否符合你的安全与合规要求。
典型用法¶
下面三步来自 README 快速开始，适合先摸清角色与档位，再审任务书，最后派活。
// 1. 看有哪些角色、各自档位与实际解析到的模型
agent_roles(action="list", lane="review")
agent_roles(action="tiers") // 档位路由表体检：配置的 provider/model 是否真的存在
// 2. 派活前先审任务书（只合成，不创建会话）
agent_taskbook(role="code-reviewer", task="评审 src/ 下这批改动，给出 P0/P1/P2 分级")
// 3. 一步派活：解析档位 → 注入人格与任务书 → 创建标准 DSH 会话并立即开跑
agent_spawn(role="executor", task="实现 X，按 tests/ 现有风格补测试")
派活方可用 de_session action=status|list 做角色回收核对。派活前建议执行 agent_roles action=tiers 查看当次生效档位与来源（tierSources），勿假设某档固定指向某个模型名。
适用场景与注意¶
适合已在 DSH 中频繁开子会话、希望把「谁做、用什么模型、交付标准」固化下来的开发者或团队。流水线类技能适合功能开发、修 bug、评审小队等可重复编排的场景；只读顾问类角色适合探索、架构讨论、代码与安全评审等需要隔离上下文的席次。
应注意：只读条款不等于宿主强制禁写；副作用关键词告警采用 fail-closed，但任务是否可行仍取决于目标会话工具与数据。配置错误会直接报错，需按 README「配置参考」与设置页调整三档路由。社区目录星标等数据会变动，以 GitHub 与目录页当时信息为准。
结尾¶
dsh-agents 把多智能体派活从「每次口述规程」收成「角色 + 档位 + 任务书 + 标准会话」一条链路，并附带工作流技能与评审、机检等扩展能力。进一步了解安装细节、技能列表与已知限制，请阅读仓库 README。
- 目录页：https://www.skillhub.cn/plugins/wangyuanchuan2022/dsh-agents
- GitHub：https://github.com/wangyuanchuan2022/dsh-agents
