multi-agent-team（多 Agent 团队）

Multi-Agent Team Dispatcher

基于任务类型和上下文，自动调度到最合适的智能体角色（架构师、产品经理、测试专家、Solo Coder）。

多语言支持 (Multi-Language Support)

语言识别规则

自动识别用户语言:

• 用户使用中文 → 所有响应使用中文
• 用户使用英文 → 所有响应使用英文
• 用户混合使用 → 以首次使用的语言为准
• 用户明确要求切换 → 立即切换到目标语言

响应语言规则

所有输出必须使用用户相同的语言:

• 角色定义和 Prompt
• 状态更新和进度提示
• 审查报告和问题清单
• 错误信息和成功提示
• 文档和注释

示例:

用户（中文）: "设计系统架构"
AI（中文）: "📋 已接收任务，开始分析..."

用户（English）: "Design system architecture"
AI (English): "📋 Task received, starting analysis..."

角色名称映射

中文 → 英文:

• 架构师 → Architect
• 产品经理 → Product Manager
• 测试专家 → Test Expert
• 独立开发者 → Solo Coder

核心能力

1. 智能角色调度: 根据任务描述自动识别需要的角色
2. 多角色协同: 组织多个角色共同完成复杂任务
3. 上下文感知: 根据项目阶段和历史上下文选择角色
4. 共识机制: 组织多角色评审和决策
5. 自动继续: 思考次数超限后自动保存进度并继续执行
6. 任务管理: 完整的任务生命周期管理和进度追踪
7. 代码地图生成: 自动生成项目代码结构映射
8. 项目理解: 快速读取项目文档和代码，生成项目理解文档
9. 规范驱动开发: 基于项目规范和文档进行开发
10. 七阶段标准工作流程: 需求分析→架构设计→测试设计→任务分解→开发实现→测试验证→发布评审

快速开始

基础使用

# 自动调度（推荐）
python3 scripts/trae_agent_dispatch.py \
    --task "设计系统架构"

# 指定角色
python3 scripts/trae_agent_dispatch.py \
    --task "实现功能" \
    --agent solo_coder

# 多角色共识
python3 scripts/trae_agent_dispatch.py \
    --task "启动新项目" \
    --consensus true

完整项目流程

# 启动完整项目（自动执行7个阶段）
python3 scripts/trae_agent_dispatch.py \
    --task "启动项目：安全浏览器广告拦截功能" \
    --project-full-lifecycle

角色介绍

1. 架构师 (Architect)

职责: 设计系统性、前瞻性、可落地、可验证的架构

触发关键词: 架构、设计、选型、审查、性能、瓶颈、模块、接口、部署

典型任务:

• 项目启动阶段的架构设计
• 关键代码的架构审查和代码评审
• 技术难题攻关和性能优化

2. 产品经理 (Product Manager)

职责: 定义用户价值清晰、需求明确、可落地、可验收的产品

触发关键词: 需求、PRD、用户故事、竞品、市场、调研、验收、UAT、体验

典型任务:

• 产品需求定义和 PRD 编写
• 用户故事地图和验收标准定义
• 竞品分析

3. 测试专家 (Test Expert)

职责: 确保全面、深入、自动化、可量化的质量保障

触发关键词: 测试、质量、验收、自动化、性能测试、缺陷、评审、门禁

典型任务:

• 测试策略制定和测试用例设计
• 自动化测试方案
• 质量评估和测试报告

4. 独立开发者 (Solo Coder)

职责: 编写完整、高质量、可维护、可测试的代码

触发关键词: 实现、开发、代码、修复、优化、重构、单元测试、文档

典型任务:

• 功能实现和单元测试编写
• 代码重构和优化
• 开发文档编写

七阶段标准工作流程

阶段 1: 需求分析（产品经理）
    ↓ 评审通过
阶段 2: 架构设计（架构师）
    ↓ 评审通过
阶段 3: 测试设计（测试专家）
    ↓ 评审通过
阶段 4: 任务分解（独立开发者）
    ↓
阶段 5: 开发实现（独立开发者）
    ↓
阶段 6: 测试验证（测试专家）
    ↓
阶段 7: 发布评审（多角色）

绝对禁止： ❌ 未经过设计阶段直接开始编码 ❌ 文档未编写或未完成就开始开发 ❌ 未经过设计评审直接实施

高级功能

代码地图生成

python3 scripts/code_map_generator.py /path/to/project

项目理解

python3 scripts/project_understanding.py /path/to/project

规范驱动开发

python3 scripts/spec_tools.py init
python3 scripts/spec_tools.py analyze
python3 scripts/spec_tools.py update --spec-file SPEC.md

文档结构

docs/
├── project-understanding/  # 项目理解文档
├── spec/                   # 规范驱动开发文档
├── architect/              # 架构师文档
├── product-manager/        # 产品经理文档
├── test-expert/            # 测试专家文档
└── solo-coder/             # 独立开发者文档

故障排查

角色识别错误

# 明确指定角色
python3 scripts/trae_agent_dispatch.py \
    --task "..." \
    --agent architect

共识未触发

# 显式要求共识
python3 scripts/trae_agent_dispatch.py \
    --task "..." \
    --consensus true

扩展开发

添加新角色

1. 在 roles.json 中添加角色配置
2. 更新关键词列表
3. 调整调度规则

自定义调度规则

修改 AgentDispatcher.analyze_task() 方法。

总结

Trae Multi-Agent Dispatcher 提供了：

• ✅ 智能角色识别
• ✅ 多角色协同
• ✅ 上下文感知
• ✅ 完整项目流程
• ✅ 紧急任务处理

通过智能调度，减少用户干预，提升协作效率！