dsh-agent-graph

多步骤任务若全靠一次对话或零散委派，容易出现上下文串味、下游默默补锅、以及节点重试后决策与踩坑记录消失。dsh-agent-graph 用机制而不是更长提示词来应对：用声明式依赖图划定节点职责，用结构化交接把上游交付传给下游，用有界返工把证据与验收标准退回直接上游，再用分层账本把进度、待办、关键决策与陷阱持久化，供人与后续激活共同阅读。

每个节点在激活时都是一次全新的 DSH 子代理，彼此不共享会话；引擎在运行前校验 YAML 图（环、未知引用、重复 id 等），按 needs 边拓扑调度，并在节点间注入 handoff（summary / artifacts / openIssues）。上游交付不足时，节点可向直接上游发起返工请求，对方可提供补充、拒绝后由请求方自行收尾，或按规则向上转发一跳；账本与 handoff 版本、运行状态落在工作区，配合 /graph status 与账本目录可观测全流程。

在 DSH Web 中，「编排」页提供拖拽式 DAG 画布、节点检视与依赖编辑，可先校验保存图再执行，避免规划阶段就拉起模型会话。图在会话内以 /graph 等人机命令驱动，节点本身仍可使用宿主授予的工具。

适合任务有真实依赖结构、参与节点超过两三个、且需要跨重试与恢复保留「谁决定了什么」的团队或个人；若只是一两次简单委派，内置子代理往往更省事。