# Multi Agent Workflow

> Multi-Agent Development Workflow

- Skill: `sean2411/multi-agent-workflow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add sean2411/multi-agent-workflow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/sean2411/multi-agent-workflow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: Sean2411 (https://skillmd.com/u/sean2411)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/sean2411/multi-agent-workflow

---

# Multi-Agent Development Workflow

## 目的
规范化多agent协作开发流程：主agent分配任务 → 开发agent实现 → 测试agent验证

## 何时使用
当用户需要完成复杂功能开发时，涉及：
- 代码实现
- 自动化测试
- 多个模块协作

## 环境配置要求

### 本地服务启动规范

**前端服务：**
- 启动脚本：`frontend/@frontend/start-local-dev.sh`
- 要求：必须运行在 **HTTPS** 上
- 默认地址：`https://localhost:3000`

**后端服务：**
- 启动脚本：`backend/@backend/start-local-dev.sh`
- 要求：必须连接到 **GCloud** 数据库（不是本地数据库）

### 测试账号

用于自动化测试和开发验证：

**管理员账号（Admin）：**
- 邮箱：`lucius2411@gmail.com`
- 密码：`123123`
- 用途：测试管理后台功能（manageTours、agents等）

**代理商账号（Agent）：**
- 邮箱：`seanlu860@gmail.com`
- 密码：`123123`
- 用途：测试代理商相关功能

### 重要提示
⚠️ 开发和测试前，确保：
1. 前端使用HTTPS协议（SSL证书已配置）
2. 后端已正确配置GCloud数据库连接
3. 两个服务都使用各自的启动脚本，不要直接用npm/yarn命令
4. 使用以上测试账号进行自动化测试和功能验证

## 工作流程

### 1. 任务分析阶段（主Agent）
- 接收用户需求
- 分解为具体的开发任务
- 创建TODO列表
- 识别需要的资源和依赖

### 2. 开发阶段（开发Subagent）
使用 `Task` 工具调用 `generalPurpose` subagent：

```
Task tool:
- subagent_type: "generalPurpose"
- description: "实现XX功能"
- prompt: 详细的开发要求，包括：
  - 功能描述
  - 技术栈
  - 文件位置
  - 代码规范
  - 返回的内容要求
```

**开发Agent职责：**
- 读取相关代码
- 实现新功能
- 编写单元测试
- 修复lint错误
- 返回实现总结

**开发时启动服务：**
- 前端开发：使用 `cd frontend && ./@frontend/start-local-dev.sh`（确保HTTPS）
- 后端开发：使用 `cd backend && ./@backend/start-local-dev.sh`（确保连接GCloud数据库）

### 3. 测试阶段（测试Subagent）

#### 前端测试
使用 `browser-use` subagent：

```
Task tool:
- subagent_type: "browser-use"
- description: "测试XX功能"
- prompt: 
  - 使用 frontend/@frontend/start-local-dev.sh 启动前端服务（HTTPS）
  - 等待服务启动完成
  - 导航到测试页面（https://localhost:3000/...）
  - 如需登录，使用测试账号：
    * 管理员：lucius2411@gmail.com / 123123
    * 代理商：seanlu860@gmail.com / 123123
  - 执行用户操作
  - 验证预期结果
  - 截图记录
```

#### 后端测试
使用 `shell` subagent：

```
Task tool:
- subagent_type: "shell"
- description: "运行后端测试"
- prompt:
  - 使用 backend/@backend/start-local-dev.sh 启动后端服务（连接GCloud数据库）
  - 等待服务启动完成
  - 运行单元测试
  - 运行集成测试
  - 检查测试覆盖率
  - 返回测试报告
```

### 4. 集成阶段（主Agent）
- 收集各subagent的结果
- 整合反馈
- 修复发现的问题
- 向用户报告完成情况

## 并行执行策略

当任务可以并行时，在同一个消息中调用多个Task：

```
同时调用：
- 开发Subagent（frontend）
- 开发Subagent（backend）
- 然后统一测试
```

## 示例用法

### 用户请求：
"添加用户登录功能"

### 主Agent执行：
1. 创建TODO：
   - [ ] 实现后端登录API
   - [ ] 实现前端登录表单
   - [ ] 测试登录流程

2. 并行调用开发agents：
   - Task 1: 后端API开发
   - Task 2: 前端UI开发

3. 串行调用测试agent：
   - Task 3: browser-use测试完整登录流程

4. 整合结果并报告

## 注意事项

1. **Context传递**：subagent不能访问用户消息，必须提供详细的prompt
2. **最多并行数**：不超过4个subagent同时运行
3. **结果处理**：subagent返回的结果需要主agent向用户总结
4. **错误处理**：如果subagent失败，主agent负责重试或修复
5. **服务启动**：
   - ✅ 必须使用指定的启动脚本
   - ✅ 前端确保HTTPS运行
   - ✅ 后端确保连接GCloud数据库
   - ❌ 不要使用 `npm start` 或 `yarn dev` 等通用命令

## 模型选择

- 快速简单任务：model="fast"
- 复杂推理任务：使用默认模型（不指定model参数）