multi-agent-team

star 28

基于任务类型动态调度到合适的智能体角色（架构师、产品经理、测试专家、独立开发者、UI 设计师）。支持多智能体协作、共识机制、完整项目生命周期管理、规范驱动开发、代码走读审查和项目理解能力。支持中英文双语。v2.4 新增 Karpathy 四大核心原则，v2.5 新增 Cybernetics 工程控制论增强。

weiransoft By weiransoft schedule Updated 6/8/2026
play_arrow Run Skill in Manus View GitHub

name: multi-agent-team slug: multi-agent-team description: 基于任务类型动态调度到合适的智能体角色（架构师、产品经理、测试专家、独立开发者、UI 设计师）。支持多智能体协作、共识机制、完整项目生命周期管理、规范驱动开发、代码走读审查和项目理解能力。支持中英文双语。v2.4 新增 Karpathy 四大核心原则，v2.5 新增 Cybernetics 工程控制论增强。

Multi-Agent Team Dispatcher (AI-Enhanced)

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

v2.5 新增（Cybernetics 工程控制论增强）:

参考来源：https://github.com/Jiaqi-Guo-0114/cybernetics-agent
理论依据：钱学森工程控制论（系统工程、系统学）、ICLR 2026 Profile-Aware Maneuvering 架构、Norbert Wiener 控制论、Ashby 必要多样性定律

  • 🔄 三环控制模型：战略层、战术层、执行层
  • 💫 反馈控制环：感知-决策-执行-反馈完整闭环
  • 📊 性能画像：执行案例记录、相似案例检索
  • 🛡️ 守护协调器：执行前验证、异常检测、AI增强风险评估

v2.4 新增（Karpathy 四大核心原则）:

  • 🧠 Think Before Coding（三思而后行）: 明确假设、呈现权衡、遇到不清就问
  • 🎯 Simplicity First（简单优先）: 最小代码、无 speculative features、无过度抽象
  • 🔬 Surgical Changes（精准修改）: 只改需要的、不改无关的、保持风格一致
  • ✅ Goal-Driven Execution（目标驱动）: 定义成功标准、验证检查点、迭代直到完成

v2.4 新增（Karpathy 四大核心原则）:

  • 🚀 代码走读与审查：多角色协作分析，生成统一代码地图和审查报告
  • 🗺️ 代码地图 Workspace 支持：支持一个 workspace 包含多个项目
  • 📊 文档对齐引擎：多角色分析结果对齐，生成共识代码地图
  • 📋 任务可视化页面：实时展现各角色任务状态、进度、依赖关系、交接过程
  • 🎨 3D 代码地图可视化：基于 Three.js 的交互式代码结构可视化，支持流动动画和主题切换
  • ✅ 文档与代码一致性检查：审查报告中新增文档与代码差异检查清单

Karpathy 四大核心原则（行为准则）

来源: Andrej Karpathy 对 LLM 编程常见陷阱的观察 目的: 减少 LLM 编程中的错误、过度复杂、无关修改等问题

所有角色必须遵守以下四大原则，详见各角色介绍中的「Karpathy 原则应用」表格。

原则 核心要求 禁止行为
🧠 Think Before Coding 明确假设、问清楚、不隐藏困惑 ❌ 假设用户意图、默默选择方案
🎯 Simplicity First 最小代码、无 speculative features ❌ 过度抽象、预留未来代码
🔬 Surgical Changes 只改必要的、保持风格一致 ❌ 溢出修改、顺手改无关代码
✅ Goal-Driven 定义成功标准、验证检查点 ❌ 不知道何时完成、跳过验证

速查:

  • 需求不明确 → 停下来问清楚
  • 考虑添加抽象 → 问"真的需要吗？"
  • 修改代码 → 只改必要的行
  • 开始实现 → 定义成功标准

详细说明和示例见 docs/guides/KARPATHY_PRINCIPLES.md。

多语言支持 (Multi-Language Support)

语言识别规则

自动识别用户语言:

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

响应语言规则

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

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

示例:

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

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

角色名称映射

中文 → 英文:

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

核心能力

AI 增强能力 (v2.1 新增)

  1. AI 语义理解驱动的角色匹配: 使用大模型理解任务的深层语义，而非简单关键词匹配
  2. 可解释的智能决策: 提供匹配原因和置信度评分，决策过程透明可解释
  3. 上下文感知的智能推理: 基于历史经验和领域知识进行智能推理
  4. 自然语言交互界面: 支持自然语言对话，理解用户意图

基础能力

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

快速开始

基础使用

# 自动调度（推荐）
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

AI 增强模式 (v2.1 新增)

# 使用 AI 语义匹配（默认）
python3 scripts/trae_agent_dispatch.py \
    --task "设计微服务架构，支持高并发和弹性扩展" \
    --agent auto  # AI 会自动匹配最合适的角色

# 查看 AI 匹配结果和解释
python3 scripts/trae_agent_dispatch.py \
    --task "实现用户认证和权限管理" \
    --agent auto \
    --explain  # 显示 AI 匹配原因和置信度

# 使用传统关键词匹配（向后兼容）
python3 scripts/trae_agent_dispatch.py \
    --task "编写单元测试" \
    --agent test_expert \
    --match-strategy keyword

AI 集成说明 (v2.1)

AI 能力

  • 语义理解: 深层语义分析、上下文感知、多义词消歧
  • 智能匹配: 多维度评分（能力 50% + 技能 30% + 语义 20%），可解释结果
  • 匹配策略: ai_enhanced（默认）、semantic、keyword、hybrid
  • 代码审查: 质量评估、性能分析、安全检查、最佳实践建议
  • 知识问答: 技术咨询、架构建议、工具推荐

AI 配置

ai_integration:
  enabled: true
  provider: trae_ai_assistant
  features:
    - semantic_matching
    - intelligent_reasoning
    - context_understanding
  config:
    max_tokens: 4096
    temperature: 0.7
    top_p: 0.9
    use_cache: true
    fallback_to_keyword: true

性能优化

  • 缓存机制: 相同请求直接返回缓存结果
  • 降级策略: AI 不可用时自动降级到关键词匹配
  • 批量处理: 支持批量请求，减少 API 调用次数

角色介绍

通用行为准则（所有角色必须遵守）

Karpathy 四大核心原则:

原则 核心要求 禁止行为
🧠 Think Before Coding 明确假设、问清楚、不隐藏困惑 ❌ 假设用户意图、默默选择方案
🎯 Simplicity First 最小代码、无 speculative features ❌ 过度抽象、预留未来代码
🔬 Surgical Changes 只改必要的、保持风格一致 ❌ 溢出修改、顺手改无关代码
✅ Goal-Driven 定义成功标准、验证检查点 ❌ 不知道何时完成、跳过验证

1. 架构师 (Architect)

职责: 设计系统性、前瞻性、可落地、可验证的架构 触发关键词: 架构、设计、选型、审查、性能、瓶颈、模块、接口、部署 详细 prompt: docs/roles/architect/prompt.md

2. 产品经理 (Product Manager)

职责: 定义用户价值清晰、需求明确、可落地、可验收的产品 触发关键词: 需求、产品、PRD、用户故事、验收标准、竞品分析 详细 prompt: docs/roles/product-manager/prompt.md

3. 测试专家 (Test Expert)

职责: 确保全面、深入、自动化、可量化的质量保障 触发关键词: 测试、质量、验收、自动化、性能测试、缺陷、评审、门禁 详细 prompt: docs/roles/test-expert/prompt.md

4. 独立开发者 (Solo Coder)

职责: 编写完整、高质量、可维护、可测试的代码 触发关键词: 实现、开发、代码、修复、优化、重构、单元测试、文档 详细 prompt: docs/roles/solo-coder/prompt.md

5. UI 设计师 (UI Designer)

职责: 创建独特、生产级的 UI 界面，具有高设计质量，避免通用的 AI "slop" 美学 触发关键词: UI设计、界面设计、前端设计、视觉设计、UI/UX、UI原型、界面美化、UI优化、UI重构 详细 prompt: docs/roles/ui-designer/prompt.md

七阶段标准工作流程

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

绝对禁止： ❌ 未经过设计阶段直接开始编码 ❌ 文档未编写或未完成就开始开发 ❌ 未经过设计评审直接实施 ❌ 使用通用的 AI 美学（AI slop）

高级功能

代码走读与审查 (v2.3)

# 执行真正的多角色协作代码走读（使用 Trae Agent 调度）
python3 scripts/multi_role_collaborative_analyzer.py /path/to/project --workspace /workspace

# 简化的多角色代码走读
python3 scripts/multi_role_code_walkthrough.py /path/to/project --workspace /workspace

真正的多角色协作分析流程:

  1. 阶段一：项目扫描

    • 递归扫描项目目录
    • 识别源代码文件、配置文件、文档文件
    • 统计项目基本信息
    • 检测技术栈和框架
    • 识别项目模块

  2. 阶段二：调用 Trae Agent 调度

    • 使用 trae_agent_dispatch_v2.py 分发任务
    • 每个角色使用专属 prompt 模板
    • 角色包括：架构师、产品经理、独立开发者、UI 设计师、测试专家
    • 各角色独立执行真实分析

  3. 阶段三：文档对齐

    • 收集各角色分析结果
    • 识别共识点与差异点
    • 合并统一的代码地图
    • 生成代码走读审查报告

输出文档:

文档 内容
<project>-ALIGNED-CODE-MAP.md 统一代码地图：项目概览、架构分层、多角色分析结果、对齐结果
<project>-CODE-REVIEW-REPORT.md 代码走读审查报告：审查概述、架构评审、代码质量评估、文档一致性检查、改进建议

代码地图内容 (核心结构，不含审查风险):

  • 项目概览
  • 架构视图
  • 代码结构
  • 多角色视角摘要
  • 分析共识

审查报告内容 (含风险和建议):

  • 审查概览
  • 架构评审
  • 代码质量评估
  • 多角色共识
  • 文档与代码一致性检查清单 ← v2.3 新增
  • 改进建议
  • 附录

3D 代码地图可视化 (v2.3)

基于 Three.js 的交互式代码结构可视化，支持流动动画和主题切换。

# 生成可视化数据
python3 scripts/code_map_generator_v2.py /path/to/project --visual
# 打开可视化页面
~/.trae/skills/docs/code-map-visualizer.html

功能: 3D 场景渲染、前后端分层、调用链路、动态流动效果、主题切换 详细说明: docs/guides/VISUALIZATION.md

任务可视化页面 (v2.3)

实时展现各角色任务状态、进度、依赖关系、交接过程。

~/.trae/skills/docs/task-visualizer.html

功能: 任务统计、角色卡片、依赖关系、交接时间线、协同关系图 详细说明: docs/guides/VISUALIZATION.md

代码地图生成

python3 scripts/code_map_generator_v2.py /path/to/project --workspace /workspace

# 输出: <project>-CODE_MAP.md

项目理解

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/        # 产品经理文档
├── tester/                 # 测试专家文档
├── solo-coder/              # 独立开发者文档
├── ui-designer/            # UI 设计师文档
└── devops/                 # DevOps 工程师文档

故障排查

角色识别错误

# 明确指定角色
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 提供了：

  • ✅ 智能角色识别
  • ✅ 多角色协同
  • ✅ 上下文感知
  • ✅ 完整项目流程
  • ✅ 紧急任务处理
  • ✅ UI 设计（避免 AI slop）

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

Install via CLI
npx skills add https://github.com/weiransoft/TraeMultiAgentSkill --skill multi-agent-team
Repository Details
star Stars 28
call_split Forks 9
navigation Branch main
article Path SKILL.md
More from Creator
weiransoft
weiransoft Explore all skills →