# AI 团队会话配置指南

本文档说明如何为编码 AI、Review AI、QA AI 创建独立的 OpenClaw 会话。

---

## 1. 会话架构

```
小虾（主会话 - 当前）
   ├── 编码 AI 会话（独立）
   ├── Review AI 会话（独立）
   └── QA AI 会话（独立）
```

**协作流程**：
1. 小虾在主会话拆解任务
2. 小虾发送任务到编码 AI 会话
3. 编码 AI 完成后，小虾发送代码到 Review AI 会话
4. Review AI 审查后，小虾发送到 QA AI 会话
5. QA AI 补充测试后，小虾收口提交

---

## 2. 创建 AI 会话

### 2.1 编码 AI 会话

**会话名称**: `xiaoxia-saas-coding-ai`  
**会话标签**: `coding-ai`  
**系统提示**: 读取 `docs/AI-PROMPTS-CODING.md`

**创建方式**：
```bash
# 方式 1: 通过 OpenClaw CLI（如果支持）
openclaw session create \
  --name "xiaoxia-saas-coding-ai" \
  --label "coding-ai" \
  --prompt-file "F:\openclaw-saas\docs\AI-PROMPTS-CODING.md"

# 方式 2: 通过 Web UI
1. 打开 OpenClaw Web UI
2. 点击 "New Session"
3. 名称: xiaoxia-saas-coding-ai
4. 标签: coding-ai
5. 复制 AI-PROMPTS-CODING.md 内容到系统提示
```

**工作目录**: `F:\openclaw-saas`

---

### 2.2 Review AI 会话

**会话名称**: `xiaoxia-saas-review-ai`  
**会话标签**: `review-ai`  
**系统提示**: 读取 `docs/AI-PROMPTS-REVIEW.md`

**创建方式**：
```bash
openclaw session create \
  --name "xiaoxia-saas-review-ai" \
  --label "review-ai" \
  --prompt-file "F:\openclaw-saas\docs\AI-PROMPTS-REVIEW.md"
```

**工作目录**: `F:\openclaw-saas`

---

### 2.3 QA AI 会话

**会话名称**: `xiaoxia-saas-qa-ai`  
**会话标签**: `qa-ai`  
**系统提示**: 读取 `docs/AI-PROMPTS-QA.md`

**创建方式**：
```bash
openclaw session create \
  --name "xiaoxia-saas-qa-ai" \
  --label "qa-ai" \
  --prompt-file "F:\openclaw-saas\docs\AI-PROMPTS-QA.md"
```

**工作目录**: `F:\openclaw-saas`

---

## 3. 会话消息传递

### 3.1 小虾 → 编码 AI

```markdown
# 任务: 为 Asset 增加 tags 字段

## 目标
Asset 可以打多个标签，用于分类和检索

## 技术约束
- 架构层：Domain + Application
- 依赖：Asset 实体
- 接口：无需新增 API，先完成领域层

## 实现要求
1. Asset 增加 tags 字段（List[str]）
2. 增加 AddTagToAssetUseCase
3. 增加 RemoveTagFromAssetUseCase
4. 补充测试

## 验收标准
- [ ] Asset.tags 字段有验证（不能有空标签、重复标签）
- [ ] 用例层正确调用 repository
- [ ] 测试覆盖添加/删除/边界场景
```

### 3.2 编码 AI → 小虾

编码 AI 完成后会在其会话中回复，小虾从该会话读取输出。

### 3.3 小虾 → Review AI

```markdown
# Review 请求: Asset 标签功能

## 改动范围
- packages/domain/entities.py - Asset 增加 tags 字段
- packages/application/assets.py - AddTagToAssetUseCase
- tests/integration/test_asset_tags.py - 测试

## 架构影响
仅增加字段和用例，不影响现有架构

## 测试覆盖
4 个测试：添加/删除/重复/空标签

## Diff
[代码 diff]
```

### 3.4 小虾 → QA AI

```markdown
# 测试设计请求: Asset 标签功能

## 功能描述
Asset 可以打多个标签，支持添加/删除标签

## 已有测试
[当前测试代码]

## 需要补充
- [ ] 边界条件
- [ ] 异常场景
- [ ] 并发场景
```

---

## 4. 使用 sessions_send 发送消息

**在小虾的主会话中**：

```python
# 发送任务到编码 AI
sessions_send(
    label="coding-ai",
    message="""
    # 任务: 为 Asset 增加 tags 字段
    ...
    """
)

# 发送代码到 Review AI
sessions_send(
    label="review-ai",
    message="""
    # Review 请求: Asset 标签功能
    ...
    """
)

# 发送测试设计请求到 QA AI
sessions_send(
    label="qa-ai",
    message="""
    # 测试设计请求: Asset 标签功能
    ...
    """
)
```

---

## 5. 监控 AI 工作状态

**老大可以**：
1. 在 OpenClaw Web UI 查看所有会话列表
2. 切换到任意 AI 会话查看实时工作过程
3. 看到每个 AI 的输入、输出、执行的命令

**小虾可以**：
1. 使用 `sessions_list()` 查看所有会话
2. 使用 `sessions_history(sessionKey="coding-ai")` 查看会话历史
3. 使用 `sessions_send()` 发送任务和接收结果

---

## 6. 验收标准

**AI 团队会话配置完成的标志**：
1. ✅ 3 个独立会话已创建（coding-ai, review-ai, qa-ai）
2. ✅ 每个会话加载了正确的系统提示词
3. ✅ 小虾可以通过 sessions_send 发送消息
4. ✅ 老大可以在 Web UI 查看每个会话的工作过程
5. ✅ 试运行一个小功能，验证协作流程顺畅

---

## 7. 下一步

1. 小虾创建 3 个 AI 会话
2. 试运行：为 Asset 增加 tags 字段
3. 验证整个协作流程
4. 记录问题与改进

---

**最后更新**: 2026-06-15  
**版本**: v1.0
