# 🤖 四AI团队协作系统邀请函

## 📩 致：Qwen、Claude、Gemini、RovoDev

### 🎯 项目简介
我们正在进行一个激动人心的OpenBB金融数据集成项目，需要四位AI专家协作完成！这个项目将传统的稷下学宫文化与现代AI技术相结合，创造出独特的多AI协作体验。

### 👥 团队角色分工

#### 🏗️ **Qwen - 架构设计师**
- **职责**: 系统架构设计、技术选型、接口规范
- **工作说明书**: [`QWEN_ARCHITECTURE_DESIGN.md`](docs/AI_AGENT_TASKS/QWEN_ARCHITECTURE_DESIGN.md)
- **专属频道**: `architecture_design`

#### 💻 **Claude - 核心开发工程师**  
- **职责**: 代码实现、API集成、界面优化
- **工作说明书**: [`CLAUDE_CODE_IMPLEMENTATION.md`](docs/AI_AGENT_TASKS/CLAUDE_CODE_IMPLEMENTATION.md)
- **专属频道**: `code_implementation`

#### 🧪 **Gemini - 测试验证专家**
- **职责**: 功能测试、性能测试、质量保证
- **工作说明书**: [`GEMINI_TEST_VALIDATION.md`](docs/AI_AGENT_TASKS/GEMINI_TEST_VALIDATION.md)
- **专属频道**: `testing_validation`

#### 📚 **RovoDev - 项目整合专家**
- **职责**: 项目管理、文档整合、协调统筹
- **工作说明书**: [`ROVODEV_PROJECT_INTEGRATION.md`](docs/AI_AGENT_TASKS/ROVODEV_PROJECT_INTEGRATION.md)
- **专属频道**: `project_integration`

---

## 🚀 如何加入协作系统

### 方式1: Web可视化界面 (推荐)
```bash
# 1. 启动Web界面
cd /home/ben/github/liurenchaxin
.venv/bin/python3 -m streamlit run app/streamlit_app.py --server.port 8502

# 2. 在浏览器中访问: http://localhost:8502
# 3. 选择 "🤖 AI协作" 标签页
# 4. 开始使用协作功能！
```

### 方式2: 命令行演示
```bash
# 查看完整协作流程演示
.venv/bin/python3 ai_collaboration_demo.py demo
```

### 方式3: 快速启动脚本
```bash
# 使用便捷脚本
./start_ai_collaboration.sh
```

---

## 📢 可用协作频道

### 🏛️ **主要频道**
- **`main_collaboration`** - 四AI主要协作讨论
- **`cross_review`** - 跨角色工作评审  
- **`emergency_coordination`** - 紧急问题处理

### 🔧 **专业频道**
- **`architecture_design`** - 架构设计讨论 (Qwen主导)
- **`code_implementation`** - 代码实现讨论 (Claude主导)
- **`testing_validation`** - 测试验证讨论 (Gemini主导)
- **`project_integration`** - 项目整合讨论 (RovoDev主导)

---

## 💬 如何在频道中协作

### 基本操作
1. **发送消息**: 选择频道、输入内容、选择接收者
2. **工作交接**: 正式的任务交接流程
3. **请求评审**: 邀请其他AI评审你的工作
4. **问题升级**: 遇到紧急问题时快速上报

### 消息类型
- 📋 **提案** - 提出建议或方案
- ❓ **询问** - 提出问题
- ✅ **回答** - 回答问题
- 📝 **评审** - 评审反馈
- 🎯 **决策** - 做出决策
- 📢 **更新** - 状态更新
- 🚨 **警报** - 警报通知
- 🔄 **交接** - 工作交接

---

## 🎭 稷下学宫文化特色

我们的协作遵循稷下学宫的传统：
- **🏛️ 开放包容** - 各种观点都能得到尊重
- **🧠 理性辩论** - 基于数据和逻辑的讨论  
- **🌟 百家争鸣** - 鼓励不同视角的碰撞
- **🤝 求同存异** - 在分歧中寻找共识

---

## 📋 Web界面功能

### 📊 **AI仪表板**
- 查看个人工作状态
- 待处理任务列表
- 协作统计数据

### 📢 **频道管理**
- 实时消息展示
- 频道成员管理
- 消息历史记录

### 🔄 **工作流管理**
- 任务交接流程
- 工作阶段推进
- 评审协作管理

### 📈 **协作分析**
- 消息统计图表
- 活跃度分析
- 协作效率评估

---

## 🔧 技术规范

### 消息格式规范
```python
# 发送消息示例
await collab.send_message(
    sender=AIRole.QWEN,  # 你的角色
    content="我已完成架构设计，请大家review",
    message_type=MessageType.PROPOSAL,
    channel_id="main_collaboration",
    receiver=None,  # None表示广播，或指定特定AI
    priority=3,  # 1-5优先级
    tags=["architecture", "review_request"]
)
```

### 工作交接示例
```python
# 工作交接示例
await collab.handoff_work(
    from_ai=AIRole.QWEN,
    to_ai=AIRole.CLAUDE, 
    task_description="基于架构设计实现OpenBB核心引擎",
    deliverables=["架构文档", "接口规范"],
    notes="请特别注意八仙数据路由的实现"
)
```

---

## 🎯 项目目标

我们的目标是创造一个：
✅ **功能完整** - OpenBB数据与八仙论道完美融合
✅ **性能稳定** - 各种场景下系统表现良好  
✅ **文化准确** - 传统文化表达准确尊重
✅ **用户友好** - 最终用户体验优秀
✅ **易于维护** - 代码和文档便于后续维护

---

## 📞 快速开始

1. **阅读你的工作说明书** - 了解具体职责和任务
2. **加入Web协作界面** - 开始实时协作  
3. **介绍自己** - 在主频道打个招呼
4. **开始工作** - 按照工作说明书开始你的任务

---

## 💡 协作提示

### ✅ 良好实践
- 📝 清晰描述你的工作进展
- 🔄 及时响应其他AI的请求
- 📋 使用合适的消息类型和标签
- 🎯 保持专业和友好的语调

### ⚠️ 注意事项  
- 🏛️ 尊重稷下学宫的文化传统
- 🧠 保持理性和建设性的讨论
- 🤝 鼓励协作而非竞争
- ⏰ 及时更新你的工作状态

---

**欢迎加入稷下学宫AI协作团队！让我们一起创造传统文化与现代技术结合的典范！** 🏛️✨

---

*"稷下学宫，百家争鸣；开源精神，技术报国！"*