Sean2411 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 - 用途：测试代理商相关功能
重要提示
⚠️ 开发和测试前，确保：
- 前端使用HTTPS协议（SSL证书已配置）
- 后端已正确配置GCloud数据库连接
- 两个服务都使用各自的启动脚本，不要直接用npm/yarn命令
- 使用以上测试账号进行自动化测试和功能验证
工作流程
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执行：
创建TODO：
- 实现后端登录API
- 实现前端登录表单
- 测试登录流程
并行调用开发agents：
- Task 1: 后端API开发
- Task 2: 前端UI开发
串行调用测试agent：
- Task 3: browser-use测试完整登录流程
整合结果并报告
注意事项
- Context传递：subagent不能访问用户消息，必须提供详细的prompt
- 最多并行数：不超过4个subagent同时运行
- 结果处理：subagent返回的结果需要主agent向用户总结
- 错误处理：如果subagent失败，主agent负责重试或修复
- 服务启动：
- ✅ 必须使用指定的启动脚本
- ✅ 前端确保HTTPS运行
- ✅ 后端确保连接GCloud数据库
- ❌ 不要使用
npm start或yarn dev等通用命令
模型选择
- 快速简单任务：model="fast"
- 复杂推理任务：使用默认模型（不指定model参数）