# trae-multi-agent-workflow

**Repository Path**: bruceleelg/trae-multi-agent-workflow

## Basic Information

- **Project Name**: trae-multi-agent-workflow
- **Description**: TraeCN 多智能体协同工作流方案 - 8智能体完整协作体系
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-28
- **Last Updated**: 2026-05-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🤖 TraeCN 多智能体协同工作流方案

[![Gitee Stars](https://gitee.com/bruceleelg/trae-multi-agent-workflow/badge/star.svg)](https://gitee.com/bruceleelg/trae-multi-agent-workflow/stargazers)
[![Gitee Forks](https://gitee.com/bruceleelg/trae-multi-agent-workflow/badge/fork.svg)](https://gitee.com/bruceleelg/trae-multi-agent-workflow/members)
[![License](https://img.shields.io/badge/License-MulanPSL--2.0-blue.svg)](./LICENSE)
[![Version](https://img.shields.io/badge/Version-4.0-green.svg)]()
[![TraeCN](https://img.shields.io/badge/IDE-TraeCN-orange.svg)](https://www.trae.ai/)

> 基于 TraeCN IDE 的 **8智能体完整协作体系**，实现从需求分析到部署上线的全流程 AI 驱动开发。

**文档版本**: 5.0 | **最后更新**: 2026-05-12 | **维护者**: BruceLee

[English](./README.en.md) | 中文

---

## 📖 这是什么？

这是一套**开箱即用的多智能体协同工作流方案**，让你在 TraeCN IDE 中用自然语言描述需求，8个 AI 智能体自动协作完成从需求分析到部署上线的全流程开发。

**核心理念**：模拟真实团队协作，每个智能体专注一个角色，由 SOLO Coder 统一调度。

| 能力 | 说明 |
|------|------|
| 🎯 产品战略师 | 自动完成市场调研、竞品分析、PRD/BRD 编写 |
| 🎨 UI/UX 设计师 | 自动生成设计系统和页面设计 |
| 🏗️ 系统架构师 | 自动完成技术选型、API 设计、数据库设计 |
| 💻 前后端开发 | 并行开发，自动联调 |
| 🧪 质量保障 | 自动执行测试和 Code Review |
| 🚀 DevOps | 自动配置 CI/CD 和容器化部署 |
| 📝 技术文档 | 自动生成完整项目文档 |

---

## ✨ 亮点特性

| 特性 | 说明 |
|------|------|
| 🧠 **项目记忆机制** | 3层记忆架构 + 4步唤醒流程，跨会话不丢失上下文 |
| 🔄 **上下文自动传递** | SOLO Coder 自动加载前置文档传给每个智能体，无需手动复制粘贴 |
| 📋 **阶段准入准出** | 每个阶段有明确的前置条件和完成标准，确保质量达标 |
| 🛡️ **错误恢复机制** | 6种失败场景的处理方案，流程不会卡死 |
| 📦 **自动归档** | Code Review 通过或需求变更后自动归档，完整记录变更历史 |
| 📊 **文档版本管理** | 同阶段小版本调整 + 跨会话大版本变更，版本清晰可追溯 |
| 💰 **Token 消耗优化** | 强制需求澄清 + 延迟归档，降低 40-58% 的 token 消耗 |

---

## 🤖 8个智能体一览

| 智能体 | 角色 | 主要输出 |
|--------|------|----------|
| 🎯 产品战略师 | 需求分析、市场调研、商业规划 | BRD、PRD、竞品分析、用户画像、数据分析方案 |
| 🎨 UI/UX 设计师 | 界面设计、用户体验 | 设计系统、组件规范、页面设计 |
| 🏗️ 系统架构师 | 技术架构设计、技术选型 | 架构文档、API 设计、数据库设计 |
| 💻 前端开发工程师 | 前端代码开发 | UI 组件、业务代码、前端测试 |
| ⚙️ 后端开发工程师 | 后端 API 开发 | 服务端代码、数据库实现、API 实现 |
| 🧪 质量保障工程师 | 测试规划、质量把控、代码审查 | 测试计划、测试报告、Code Review |
| 🚀 DevOps 工程师 | 部署自动化、运维配置 | Docker、CI/CD、监控配置 |
| 📝 技术文档工程师 | 技术文档编写 | 开发指南、API 文档、用户手册 |

---

## 🏗️ 工作流阶段

```
Phase 1.0  需求变更处理（按需）
    ↓
Phase 1.2  需求分析 → 产品战略师输出 PRD/BRD
    ↓
Phase 1.3  技术架构 → 系统架构师输出架构设计
    ↓
Phase 2.1  详细设计 → UI设计师 + 架构师并行输出设计稿/API/数据库
    ↓
Phase 3.1  代码实现 → 前后端开发并行编码
    ↓
Phase 3.3  测试 → QA执行测试
    ↓
Phase 3.4  代码审查 → Code Review
    ↓
Phase 3.5  部署上线 → DevOps容器化部署
    ↓
归档 → 自动归档记录
```

每个阶段都有明确的**准入/准出标准**，确保质量达标才进入下一阶段。

---

## 🧠 核心机制

### 1. 项目记忆机制

解决"每次新会话都从零开始"的问题。3层记忆架构 + 4步唤醒流程：

```
Layer 0: 对话上下文（临时）
Layer 1: 规则文件（持久）⭐ workflow-rules.md 等
Layer 2: 产出文档（持久）⭐ PRD/BRD/架构文档
Layer 3: 归档记录（持久）⭐ 历史变更总览
```

### 2. 上下文传递规范

SOLO Coder 是唯一的信息中转站。每次调用子智能体时，自动加载对应的前置文档作为上下文传入。

### 3. 文档版本管理

- 同阶段内调整：小版本号（v1.0 → v1.1），直接修改原文档
- 跨会话变更：大版本号（v1.0 → v2.0），生成变更评估报告

### 4. 归档机制

两种自动触发方式：
- **Code Review 通过后** → qa-engineer 执行归档
- **需求变更评估完成后** → SOLO Coder 执行归档

每次归档包含4个核心文件：变更摘要、变更文件列表、测试结果、Review记录。

### 5. 错误恢复机制

6种失败场景的处理方式和回退原则，确保流程不会卡死。

---

## 📁 项目结构

```
trae-workflow/
├── .trae/                               # Trae 配置目录 ⭐
│   ├── rules/                           # 规则文件（6个）
│   │   ├── workflow-rules.md            # 工作流规则（核心）
│   │   ├── project-conventions.md       # 项目规范
│   │   ├── coding-standards.md          # 编码规范
│   │   ├── archives-rules.md            # 归档规则
│   │   ├── documentation-rules.md       # 文档规则
│   │   └── testing-rules.md             # 测试规则
│   └── agents/                          # 智能体配置（8个）
│       ├── product-strategist.json
│       ├── ui-ux-designer.json
│       ├── system-architect.json
│       ├── frontend-developer.json
│       ├── backend-developer.json
│       ├── qa-engineer.json
│       ├── devops-engineer.json
│       └── tech-doc-writer.json
│
├── docs/                                # 文档目录
│   ├── prd.md                           # 产品需求文档
│   ├── brd.md                           # 商业需求文档
│   ├── research/                        # 调研报告
│   │   ├── competitor-analysis.md       # 竞品分析
│   │   └── user-personas.md             # 用户画像
│   └── analytics/
│       └── tracking-plan.md             # 数据分析方案
│
├── archives/                            # 归档目录
│   ├── README.md                        # 归档总索引
│   ├── index/
│   │   ├── by-date.md                   # 按日期索引
│   │   └── by-type.md                   # 按类型索引
│   └── YYYY-MM-DD-<change-id>/          # 每次变更的归档记录
│       ├── summary.md
│       ├── files-changed.md
│       ├── test-results.md
│       └── review-record.md
│
├── TraeCN项目从0到1多智能体协同团队方案.md  # 完整方案文档 ⭐
├── 智能体导入快速指南.md                    # 快速导入指南 ⭐
├── SKILLS.md                              # Skills 清单
└── README.md                              # 本文件
```

---

## 🚀 快速开始

### 方式一：克隆仓库（推荐）

```bash
git clone https://gitee.com/bruceleelg/trae-multi-agent-workflow.git
cd trae-multi-agent-workflow
```

### 方式二：下载 ZIP

在码云仓库页面点击「克隆/下载」→「下载ZIP」，解压到任意目录。

### 导入到你的项目

1. 将 `.trae/` 目录复制到你的项目根目录
2. 将 `SKILLS.md` 复制到项目根目录
3. 按照 [智能体导入快速指南](智能体导入快速指南.md) 在 TraeCN 中逐一导入8个智能体
4. 按照 [SKILLS.md](SKILLS.md) 安装全局 Skills
5. 在 TraeCN 中打开项目，输入需求即可开始

### 安装全局 Skills

```bash
# 测试相关
npx skills add nicholasgriffintn/jest-react-testing@jest-react-testing -g -y
npx skills add nicholasgriffintn/playwright-e2e-testing@playwright-best-practices -g -y

# 代码审查
npx skills add nicholasgriffintn/code-reviewer@requesting-code-review -g -y

# 部署相关
npx skills add nicholasgriffintn/docker-compose-setup@docker-deployment -g -y
```

详见 [SKILLS.md](SKILLS.md) 中的完整清单和说明。

---

## 📚 文档导航

| 文档 | 说明 | 适合人群 |
|------|------|---------|
| [智能体导入快速指南.md](智能体导入快速指南.md) | 8个智能体的完整配置和导入步骤 | 首次使用 |
| [TraeCN项目从0到1多智能体协同团队方案.md](TraeCN项目从0到1多智能体协同团队方案.md) | 完整方案文档，包含所有机制和规范 | 深入了解 |
| [SKILLS.md](SKILLS.md) | Skills 清单、安装脚本、与智能体对应关系 | 环境配置 |
| [docs/prd.md](docs/prd.md) | PKM 项目的 PRD 示例 | 参考示例 |
| [docs/brd.md](docs/brd.md) | PKM 项目的 BRD 示例 | 参考示例 |
| [archives/README.md](archives/README.md) | 归档总索引 | 查看历史 |

---

## 📋 规则文件说明

| 规则文件 | 作用 | 优先级 |
|---------|------|--------|
| [workflow-rules.md](.trae/rules/workflow-rules.md) | 核心工作流，定义8智能体协作流程、记忆机制、上下文传递、准入准出、错误恢复、版本管理 | ⭐⭐⭐ |
| [archives-rules.md](.trae/rules/archives-rules.md) | 归档规范，定义触发方式、目录结构、索引模板 | ⭐⭐⭐ |
| [project-conventions.md](.trae/rules/project-conventions.md) | 项目规范，定义目录结构、分支策略、提交规范 | ⭐⭐ |
| [coding-standards.md](.trae/rules/coding-standards.md) | 编码规范，定义命名约定、代码组织、错误处理 | ⭐⭐ |
| [testing-rules.md](.trae/rules/testing-rules.md) | 测试规范，定义测试金字塔、覆盖率要求、报告模板 | ⭐⭐ |
| [documentation-rules.md](.trae/rules/documentation-rules.md) | 文档规范，定义文档模板、更新流程 | ⭐ |

---

## 📊 示例项目：个人知识管理系统（PKM）

当前仓库包含一个完整的 **PKM（Personal Knowledge Management）** 项目作为示例，展示了产品战略师阶段的完整产出：

- [商业需求文档 (BRD)](docs/brd.md) - 商业目标、市场分析、盈利模式
- [产品需求文档 (PRD)](docs/prd.md) - 功能定义、用户故事、验收标准
- [竞品分析报告](docs/research/competitor-analysis.md) - 市场竞争格局分析
- [用户画像文档](docs/research/user-personas.md) - 目标用户特征和需求
- [数据分析方案](docs/analytics/tracking-plan.md) - 埋点方案和指标定义

---

## 🔧 使用方式

### 新项目启动

```
1. 在 TraeCN 中打开你的项目
2. 输入你的需求描述（例如："我要做一个电商小程序"）
3. SOLO Coder 自动检测项目状态
4. 按阶段推进：需求分析 → 架构设计 → 详细设计 → 编码 → 测试 → 部署
5. 每个阶段完成后向你汇报，你确认后才进入下一阶段
```

### 已有项目追加需求

```
1. 在 TraeCN 中打开已有项目
2. 提出新需求（例如："新增支付模块"）
3. SOLO Coder 自动加载项目记忆（PRD、架构、归档记录）
4. 展示项目状态摘要
5. 判断需求类型，启动对应流程
```

### 需求变更

```
1. 提出变更需求
2. SOLO Coder 执行【强制需求澄清流程】（2-3轮）
   - Step 1: 复述理解并确认
   - Step 2: 深挖细节与约束
   - Step 3: 方案预览与最终确认
3. 评估变更影响（影响哪些文档、哪些模块）
4. 调用对应智能体更新受影响的文档
5. 生成变更评估报告
6. 【延迟归档】用户明确说"满意"后才归档
```

**Token 优化说明**：
- 修改期间只更新版本号，不触发归档
- 只有最终确认满意后才归档，避免无效 token 消耗

---

## 📅 更新日志

| 日期 | 内容 |
|------|------|
| 2026-05-12 | **v5.0** - 新增 Token 消耗优化机制：强制需求澄清流程（2-3轮）、延迟归档时机（用户明确满意后才归档）、Token 消耗优化策略文档 |
| 2026-04-29 | v4.0 - 补充上下文传递规范、阶段准入准出标准、错误恢复机制、文档版本管理规范、归档日期强制规则、项目记忆机制 |
| 2026-04-24 | 修复需求变更流程缺少归档的问题，补充归档触发机制 |
| 2026-04-22 | 完成 PKM 产品战略分析，输出 BRD/PRD/竞品分析/用户画像/数据分析方案 |
| 2026-04-17 | 明确 UI 设计师和架构师职责边界，集成8个智能体分享链接和全局技能 |
| 2026-04-16 | 完善工作流文档体系：需求变更处理规范、产品战略师职责扩展 |
| 2026-04-15 | 初始化项目，定义8智能体协作框架 |

---

## 🤝 参与贡献

1. Fork 本仓库
2. 创建你的特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交你的更改 (`git commit -m 'feat: 添加某个特性'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开一个 Pull Request

---

## 📄 许可证

本项目采用 [木兰宽松许可证，第2版](http://license.coscl.org.cn/MulanPSL2) 开源许可证。详见 [LICENSE](./LICENSE) 文件。

---

## 💬 反馈与交流

如果你在使用过程中遇到问题或有改进建议，欢迎：

- 提交 [Issue](https://gitee.com/bruceleelg/trae-multi-agent-workflow/issues)
- 发起 [Pull Request](https://gitee.com/bruceleelg/trae-multi-agent-workflow/pulls)

---

**Made with ❤️ by BruceLee**