# multi-agent-serial

**Repository Path**: openus/multi-agent-serial

## Basic Information

- **Project Name**: multi-agent-serial
- **Description**: trae 使用多个agent协同串行工作
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Multi-Agent-Serial 多Agent串行协作系统

## 项目简介

Multi-Agent-Serial 是一个多Agent串行协作系统，旨在通过协调产品、后端、前端、测试等Agent来实现用户需求。该系统采用串行工作流程，每个Agent按照既定顺序执行各自负责的工作，最终完成完整的产品功能开发。

## 系统架构

### Agent 角色体系

系统包含五个核心Agent角色：

| Agent | 职责 |
|-------|------|
| **Coordinator** | 协调者，负责整体工作流程的调度与管理 |
| **Product** | 产品，负责需求分析、需求文档整理与确认 |
| **Backend** | 后端，负责数据库设计、接口开发、接口文档编写 |
| **Frontend** | 前端，负责根据接口文档开发前端页面 |
| **QA** | 测试，负责功能测试、接口测试、边界测试与UI测试 |

### 工作流程

```
用户需求 → 产品需求分析 → 后端开发 → 前端开发 → 测试 → 产品确认 → 用户确认 → 完成
```

## 各Agent详细说明

### 1. 协调者 (Coordinator)

协调者是系统的核心，负责管理和调度其他Agent按照正确的顺序执行任务。

**管理Agent列表：**
- Product Master
- Backend Master
- Frontend Master
- QA Master

**工作流程：**
1. 需求分析
2. 后端开发
3. 前端开发
4. 测试
5. 产品确认
6. 用户确认
7. 完成
8. 优化

### 2. 产品工作 (Product)

产品Agent负责需求分析阶段的工作产出。

**工作内容：**
- 需求分析
- 需求文档输出
- 需求确认

**输出文档格式：**
- 功能名称
- 功能描述
- 功能列表
- 数据字段设计建议
- 接口设计建议
- 前端页面设计建议

### 3. 后端工作 (Backend)

后端Agent负责实现服务端的全部技术工作。

**职责：**
- 数据库设计
- API接口开发
- 接口文档编写
- 自测验证

**技术规范：**
- Controller层规范
- MyBatis规范
- 数据库规范
- URL规范

### 4. 前端工作 (Frontend)

前端Agent负责根据接口文档实现用户界面。

**技术栈：**
- React/Vue 框架
- API封装
- 组件化开发

**开发规范：**
- API封装规范
- 组件命名规范
- 样式规范

**页面设计要点：**
- 布局结构
- 交互设计
- 视觉设计

### 5. 测试工作 (QA)

测试Agent负责验证功能实现是否符合需求。

**测试类型：**
- 功能测试
- 接口测试
- 边界测试
- UI测试

**测试用例格式：**
- 用例名称
- 前置条件
- 测试步骤
- 预期结果
- 实际结果
- 测试状态

## 项目结构

```
.
├── .trae/
│   └── skills/
│       ├── backend-work/      # 后端工作Skill
│       ├── coordinator/       # 协调者Skill
│       ├── frontend-work/     # 前端工作Skill
│       ├── product-work/      # 产品工作Skill
│       └── qa-work/           # 测试工作Skill
└── flow.md                    # 工作流程文档
```

## 使用说明

### 启动协调者

当用户提出新功能需求时，调用Coordinator Agent启动整个工作流程。

```bash
# 触发协调者工作
coordinator.start(requirements)
```

### 工作流程执行

1. **需求提交**：用户描述需求
2. **产品分析**：Product Agent分析需求并输出需求文档
3. **后端开发**：Backend Agent根据需求设计数据库并开发接口
4. **前端开发**：Frontend Agent根据接口文档开发前端页面
5. **测试验证**：QA Agent执行测试用例验证功能
6. **产品确认**：Product Agent确认功能实现
7. **用户确认**：用户验收最终功能
8. **完成归档**：功能上线并完成文档归档

## 接口文档示例

### 新增接口文档格式

```markdown
## 接口名称
XXX功能接口

## 接口地址
POST /api/xxx

## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| xxx    | String | 是   | xxx |

## 响应参数
| 参数名 | 类型 | 说明 |
|--------|------|------|
| code   | int  | 状态码 |
| data   | obj  | 数据   |

## 示例
请求示例...
响应示例...
```

## 测试用例示例

```markdown
### 测试用例：用例名称

- **前置条件**：xxx
- **测试步骤**：
  1. 步骤1
  2. 步骤2
- **预期结果**：xxx
- **实际结果**：xxx
- **测试状态**：通过/失败
```

## 注意事项

1. **串行执行**：各Agent按顺序执行，确保前一个环节完成后才进入下一环节
2. **文档驱动**：前端开发以后端接口文档为依据，确保接口一致性
3. **测试覆盖**：每个功能都需要完整的测试用例覆盖
4. **需求确认**：产品确认和用户确认是必经环节，不可跳过

## 参与贡献

欢迎提交Issue和Pull Request，共同完善多Agent协作系统。

## 许可证

本项目仅供学习和研究使用。