dsh-team-superflow: 固定五人开发团队与 Spec-Superflow 状态机

前言¶

在 DeepSeek Harness (DSH) 中，管理多智能体协作流程时，往往需要手动定义角色和任务流转。dsh-team-superflow 插件提供了一套标准化的解决方案，通过预定义的固定成员名单和 spec-superflow 状态机，将开发流程（从需求分析到交付）标准化，并在 Web 界面提供可视化进度追踪。

插件介绍¶

这是一个由 fengbin01 维护的插件，核心功能是启动一个包含 5 名固定成员的团队（队长、规格撰写者、架构师、工程师、审查者、文档维护者）。它将工作流拆分为 8 个阶段，并在 Web 界面提供可视化步骤条。

该插件重构自 NanmiCoder/dsh-agent-teams，集成了 MageByte-Zero/spec-superflow 的状态机模型。

核心功能¶

固定成员名单¶

每次通过 agent_teams_create 创建团队时，都会注册固定的 5 名成员。这些成员会在首次被分配到其职责范围内的阶段任务时才被激活：

成员	角色	活跃阶段
spec-writer	规格撰写者	exploring · specifying · bridging
architect	设计师 / 架构师	specifying · bridging
engineer	工程师	executing · debugging
reviewer	审查者	executing · debugging
docs	文档 / 发布	executing · closing

状态机工作流¶

团队记录维护 spec-superflow 的八阶段工作流：

exploring → specifying → bridging → approved-for-build → executing ⇄ debugging → closing
                                    │
                                    └─ build gate: HUMAN approval before executing
(any non-terminal state) ─────────→ abandoned (terminal)

关键特性：
* 自动推进：当当前阶段的所有任务完成时，团队自动进入下一阶段（默认开启）。
* 构建门禁：实现过程在 approved-for-build 状态冻结，直到人类在 Web 面板审查执行契约工件并点击「批准构建」。模型无法确认门禁。
* 回滚：队长可回退到 specifying（范围变更）或 bridging（契约漂移）；Bug 会导致 executing → debugging，修复后自动返回。
* 阶段标记任务：agent_teams_create_task 将任务标记为特定阶段，调度器仅分发符合当前阶段和成员角色范围的任务。

Web GUI 可视化¶

活动面板中添加了一个状态机步骤条（八阶段胶囊状指示器、整体百分比、每阶段任务计数、构建门禁徽章），数据从持久化的宿主状态中刷新。

可用工具¶

插件提供了一系列命令来管理团队和任务：

agent_teams_create: 创建团队，注册固定成员名单，开始探索阶段。
agent_teams_add_member: 在固定名单外添加额外成员（可选工作流阶段范围）。
agent_teams_remove_member: 安全移除成员，撤销其未完成任务，中断其轮次。
agent_teams_create_task: 创建带有依赖关系的阶段标记任务（默认为当前阶段）。
agent_teams_reassign_task: 原子性地重试/重新分配/接手任务，撤销旧尝试。
agent_teams_claim_task: 领取一个就绪任务并接收 attempt_id 能力。
agent_teams_update_task: 推进任务状态/输出；当前阶段任务全部完成后自动推进团队。
agent_teams_send_message: 通过持久化邮箱直接向队长/成员发送消息。
agent_teams_status: 读取当前阶段、每阶段进度、成员活动、任务、工件和构建门禁状态。
agent_teams_advance_phase: 推进/回退状态机；构建门禁需在面板中人工批准。
agent_teams_delete: 结束团队并归档（任务、邮箱、工件和阶段历史保留在 archive/ 下）。

安装与启用¶

环境要求¶

DeepSeek Harness
Node.js 版本: ^22.19.0 || >=24

安装命令¶

在终端中执行以下命令以安装插件：

dsh plugin --profile web add https://gitee.com/quella01/dsh-team-superflow.git

典型用法¶

自然语言指令¶

Use AgentTeams to add a dark mode to this repo, following spec → contract → implement → review.

斜杠命令¶

/agent-teams refactor the auth boundary and produce the full execution contract and tests

配置示例¶

在 DSH 的配置文件中，可以启用并配置该插件：

- id: agent-teams
  config:
    stateDir: .agent-teams
    memberProvider: spawn
    memberModel: deepseek-v4
    memberMaxDepth: 1
    maxMembers: 8
    fixedRoster: true          # false → 原始行为（空团队）
    phaseAutoAdvance: true
    promptSectionOrder: 117
    slashCommand: true

注意事项¶

构建门禁：构建门禁必须在 Web 面板中由人工批准。
持久化状态：团队记录持久化在 .agent-teams 目录下。
本地开发：支持本地克隆和链接（link:~/path/to/repo），修改代码后重建即可生效。
许可证：MIT。

总结¶

dsh-team-superflow 为 DSH 提供了一套标准化的多智能体协作框架。通过固定的角色分工和可视化的状态机流程，它简化了从需求到交付的自动化协作复杂度，适合需要结构化工作流的开发场景。

目录页: dsh-team-superflow
源码仓库: fengbin01/dsh-team-superflow