docs: add AI session setup guide for multi-session collaboration
- session architecture: main + coding-ai + review-ai + qa-ai - session creation steps - message passing examples - monitoring guide - acceptance criteria
This commit is contained in:
Xiaoxia AI
@@ -0,0 +1,229 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user