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