diff --git a/docs/AI-SESSION-SETUP.md b/docs/AI-SESSION-SETUP.md new file mode 100644 index 000000000..e19d45a22 --- /dev/null +++ b/docs/AI-SESSION-SETUP.md @@ -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