# dsh-team-superflow

**Repository Path**: quella01/dsh-team-superflow

## Basic Information

- **Project Name**: dsh-team-superflow
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-21
- **Last Updated**: 2026-09-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dsh-team-superflow

<p align="center">
  <strong>固定五人的开发团队 · spec-superflow 状态机驱动 · Web 实时进度</strong>
</p>

在 DeepSeek Harness 中一句话拉起一支**固定成员的开发团队**：每次使用 AgentTeams 都得到同一套五人阵容，团队工作流沿 spec-superflow 的 8 态状态机推进，Web 活动面板用 Stepper 显示总体进度。

基于 [NanmiCoder/dsh-agent-teams](https://github.com/NanmiCoder/dsh-agent-teams) 重构，融入 [MageByte-Zero/spec-superflow](https://github.com/MageByte-Zero/spec-superflow) 的状态机模型。

## 演示

<p align="center">
  <img src="./assets/demo1.png" alt="演示 1" width="100%">
</p>

<p align="center">
  <img src="./assets/demo2.png" alt="演示 2" style="max-width: 420px; width: 100%;">
  <img src="./assets/demo3.png" alt="演示 3" style="max-width: 420px; width: 100%;">
</p>

## 固定阵容

队长即当前会话。每次创建团队自动注册以下五名成员（按需懒生成子 Agent，首次进入所属阶段才真正 spawn）：

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

## 状态机

团队工作流采用 spec-superflow 的 8 态状态机，作为一等状态持久化在团队记录中：

```text
exploring → specifying → bridging → approved-for-build → executing ⇄ debugging → closing
                                    │
                                    └─ 构建关卡：人工批准后才进入 executing
(任意非终态) ──────────────→ abandoned（终态）
```

- **自动推进**：当前阶段的任务全部完成后自动进入下一阶段（`phaseAutoAdvance`，默认开）。
- **关键关卡（人工审查）**：进入 `approved-for-build` 后实现被冻结——必须由**真人**在 Web 浮层点击「批准构建」（先审查 execution-contract.md 与制品），模型调用 `agent_teams_advance_phase` 无法自行通过关卡。
- **倒带**：队长可随时 `agent_teams_advance_phase` 回到 specifying（范围变化）或 bridging（契约漂移）；执行遇 bug 可进入 debugging，修复完成后自动回到 executing。
- **任务分阶段**：`agent_teams_create_task` 为任务打阶段标签（默认当前阶段），调度器只派发与当前阶段匹配、且成员角色允许的任务。
- **阶段制品**：团队按 spec-superflow 生成阶段 MD 文档到 `<workspace>/.agent-teams/<teamId>/artifacts/`（exploration.md → proposal.md/design.md/tasks.md/specs/ → execution-contract.md → implementation-log.md → README.md 总结），成员在所属阶段任务中负责填写，状态接口可列出。

Web 活动面板顶部新增**状态机 Stepper**：8 个阶段胶囊 + 总体百分比 + 各阶段任务计数 + 构建关卡徽标，磁盘状态轮询刷新。

## 安装

> 先安装 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。

### 方式 A：git 仓库直装（推荐；GitHub 或 Gitee 均可）

```sh
dsh plugin --profile web add https://gitee.com/quella01/dsh-team-superflow.git
# dsh plugin --profile web add https://github.com/fengbin01/dsh-team-superflow.git
```

### 方式 B：clone 后本地链接（可改代码、随改随生效）

```sh
git clone https://gitee.com/quella01/dsh-team-superflow.git ~/dsh-team-superflow
dsh plugin --profile web add link:~/dsh-team-superflow
```

### 方式 C：npm 包形态（发布后，暂未发布）

```sh
dsh plugin --profile web add dsh-team-superflow
```

## 使用

无需特定话术，直接自然语言即可：

> 使用 AgentTeams 给这个仓库加一个暗色模式，按规格→契约→实现→审查的流程推进。

或使用 slash 命令确定性激活：

```
/agent-teams 重构认证边界，输出完整的执行契约与测试
```

队长协议（写入系统提示词的 usage 段落）：
1. `agent_teams_create` 建队（自动带五人固定阵容，从 exploring 开始）。
2. 按阶段创建带依赖的任务；调度器自动唤醒当前阶段可用的空闲成员（含懒生成）。
3. 阶段任务完成 → 自动推进；`approved-for-build` 处等待**人工批准**（Web 面板「批准构建」），模型无法自行通过关卡。
4. 用 `agent_teams_status` 查看阶段与各阶段进度；遇 bug 进 `debugging`；范围/契约变化倒带。
5. 全部完成后 `agent_teams_delete` 归档（历史保留在 `archive/` 供复盘）。

## 工具

| 工具 | 能力 |
| --- | --- |
| `agent_teams_create` | 创建团队：自动注册固定五人阵容，从 exploring 开始，并生成 spec-superflow 制品目录 |
| `agent_teams_add_member` | 在固定五人之外按需添加额外成员（可限定其活跃阶段） |
| `agent_teams_remove_member` | 安全移除成员：撤销其进行中任务、中断其回合并标记 removed |
| `agent_teams_create_task` | 创建带阶段标签与依赖的任务（默认当前阶段；依赖未完成不可认领） |
| `agent_teams_reassign_task` | 失败/阻塞/接管时原子重派任务，撤销旧 attempt 防迟到结果覆盖 |
| `agent_teams_claim_task` | 认领一个就绪任务，返回 `attempt_id` 能力凭据 |
| `agent_teams_update_task` | 推进任务状态/输出；当前阶段任务全部完成时触发自动推进 |
| `agent_teams_send_message` | 队长/成员间通过持久化邮箱直达消息 |
| `agent_teams_status` | 查看当前阶段、各阶段进度、成员活动、任务、制品与构建关卡状态 |
| `agent_teams_advance_phase` | 推进/倒带状态机：进入 debugging、回退（bridging/specifying）、放弃；批准构建关卡需人工在面板确认 |
| `agent_teams_delete` | 结束团队并归档（任务、邮件、制品与阶段历史保留在 `archive/`） |

## 配置

```yaml
- id: agent-teams
  config:
    stateDir: .agent-teams      # 团队状态目录（workspace 下）
    memberProvider: spawn       # 子 Agent 后端 spawn / fork
    memberModel: deepseek-v4    # 全体成员模型默认覆盖（可选）
    memberMaxDepth: 1
    maxMembers: 8               # 成员上限（含固定五人，超出需用 add_member）
    fixedRoster: true           # false 则退化为原版：空团队，队长自行加人
    phaseAutoAdvance: true      # 阶段任务完成后自动推进
    promptSectionOrder: 117
    slashCommand: true
```

## 许可证

MIT