xiaoxia-saas/docs/AI-SESSION-SETUP.md

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

创建方式：

# 方式 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

创建方式：

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

创建方式：

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

# 任务: 为 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

# 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

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

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

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

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

---

4. 使用 sessions_send 发送消息

在小虾的主会话中：

# 发送任务到编码 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