# AI 工具准备清单 - 新 SaaS 项目正式启动

**目标**: 按照既定分工制度，准备好所有 AI 角色的工具和协作环境

**时间**: 2026-06-15 开始准备

---

## 1. 当前已有的工具

### ✅ 已配置且可用
- **OpenClaw + Codex** - 小虾当前使用（但需要按角色重新定位）
- **Gitea** - 代码仓库（`xiaoxia-server:/var/lib/xiaoxia-ci/xiaoxia-saas.git`）
- **ChatGPT/Claude** - 老大使用（用于产品决策、目标定义）

### ⚠️ 需要重新定位
- OpenClaw 当前既是技术 owner 又是编码工具，需要明确角色分离

---

## 2. 需要准备的 AI 工具（按优先级）

### 🔴 P0 - 立即需要（本周内）

#### 2.1 编码 AI - Codex
**角色**: 编码 AI  
**负责**: 具体模块实现、前后端编码  
**用户**: 小虾（技术 owner 发起任务）

**准备步骤**:
1. ✅ 已有访问权限（通过 OpenClaw）
2. ✅ 已克隆新 SaaS 仓库（`F:\openclaw-saas`）
3. 建立编码 AI 独立会话（与小虾的技术 owner 会话分离）
4. 配置编码 AI 系统提示词（定义代码风格、架构约束）
5. 建立编码 AI 协作模板：
   - 输入：任务描述 + 架构约束 + 接口定义
   - 输出：代码 + 单元测试 + commit message

**验证标准**:
- 能够读取现有代码库
- 能够按照 Clean Architecture 规范生成代码
- 能够自动运行测试
- 能够生成符合规范的 commit message

**优势**:
- 已有访问，无需额外订阅
- 整体视角，理解架构全局
- 端到端执行：代码 → 测试 → commit → push
- 适合架构驱动的开发模式

---

#### 2.2 Review AI - 独立 Claude/ChatGPT 会话
**角色**: Review AI  
**负责**: 代码审查、架构一致性检查、风险提示  
**用户**: 小虾（负责发起 review）

**准备步骤**:
1. 创建独立的 Claude/ChatGPT 会话（不与编码会话混用）
2. 建立 Review AI 系统提示词：
   ```
   你是一个代码审查专家，专注于：
   - Clean Architecture 架构一致性
   - 安全漏洞检查
   - 性能风险识别
   - 测试覆盖率评估
   - 文档完整性检查
   
   项目背景：小虾 AI 视频自动化剪辑 SaaS 系统
   技术栈：Python 3.12 + FastAPI + Celery + PostgreSQL
   架构：Clean Architecture (Domain/Application/Ports/Adapters)
   ```
3. 建立 Review 输入输出模板：
   - 输入：代码 diff + 任务描述 + 架构文档
   - 输出：Review 意见（通过/修改建议/拒绝）+ 风险等级

**验证标准**:
- 能够识别架构偏离
- 能够发现潜在 bug
- 能够给出建设性建议

---

#### 2.3 QA AI - 独立 Claude/ChatGPT 会话
**角色**: QA AI  
**负责**: 测试设计、回归场景、bug 分析  
**用户**: 小虾（负责发起测试设计）

**准备步骤**:
1. 创建独立的 Claude/ChatGPT 会话（不与编码/review 混用）
2. 建立 QA AI 系统提示词：
   ```
   你是一个测试专家，专注于：
   - 集成测试设计
   - 边界条件识别
   - 异常场景覆盖
   - 回归测试建议
   - Bug 复现与分类
   
   项目背景：小虾 AI 视频自动化剪辑 SaaS 系统
   技术栈：pytest + in-memory/SQLite 测试环境
   测试策略：集成测试优先
   ```
3. 建立 QA 输入输出模板：
   - 输入：功能描述 + 已有测试
   - 输出：补充测试场景 + 测试代码 + 风险提示

**验证标准**:
- 能够设计完整的测试场景
- 能够发现边界条件
- 能够补充异常场景

---

### 🟡 P1 - 启动前端时需要（Phase 2-3）

#### 2.4 UI AI - v0 或 Figma AI
**角色**: UI AI  
**负责**: 页面结构、交互流、原型草图  
**用户**: 老大或指定 UI 负责人

**准备步骤**:
1. 开通 v0 账号（https://v0.dev/）或 Figma Pro
2. 准备设计系统基础：
   - 色彩规范
   - 组件规范
   - 交互规范
3. 建立 UI AI 协作模板：
   - 输入：功能描述 + 用户流程
   - 输出：页面原型 + 组件清单 + 交互说明

**验证标准**:
- 能够快速生成可交互原型
- 符合设计规范
- 能够导出前端代码骨架

---

### 🟢 P2 - Phase 3 后补充（扩展能力）

#### 2.5 编码 AI - Cursor（备选）
**角色**: 编码 AI（备选）  
**负责**: IDE 集成编码、快速补全  
**用户**: 小虾或指定编码执行者

**准备步骤**:（当 Codex 无法满足需求时再开通）
1. 订阅 Cursor Pro
2. 配置工作区和 Python 环境
3. 配置 `.cursorrules` 文件

**适用场景**:
- 大量前端交互代码
- 需要即时补全的快速编码
- Codex 有明显局限时

---

#### 2.6 知识库 AI - 文档检索增强
**角色**: 知识管理  
**负责**: 文档检索、历史决策查询、知识沉淀  
**用户**: 全员

**准备步骤**:（暂缓）

---

## 3. AI 协作环境配置

### 3.1 统一文档源
**位置**: `F:\openclaw-saas\docs\`

**必备文档**:
- ✅ `saas-index.md` - 总索引
- ✅ `saas-project-structure-spec.md` - 项目结构
- ✅ `saas-core-objects.md` - 核心对象
- ✅ `saas-core-flows.md` - 核心流程
- ✅ `saas-development-workflow.md` - 开发流程
- ✅ `ai-team-tooling-checklist.md` - AI 工具清单
- 🔲 `CODING-STANDARD.md` - 编码规范（待补充）
- 🔲 `API-SPEC.md` - API 规范（待补充）
- 🔲 `TESTING-GUIDE.md` - 测试指南（待补充）

### 3.2 协作模板

#### 任务分配模板
```markdown
# 任务: [功能名称]

## 背景
[为什么做这个功能]

## 目标
[预期达到的效果]

## 范围
- 包含：[明确范围]
- 不包含：[明确边界]

## 技术约束
- 架构层：[Domain/Application/Ports/Adapters]
- 依赖：[需要哪些已有模块]
- 接口：[API/Worker/Database]

## 验收标准
- [ ] 功能完整
- [ ] 测试通过
- [ ] Review 通过
- [ ] 文档更新

## 分工
- 架构设计：小虾
- 编码实现：编码 AI (Cursor)
- 代码审查：Review AI
- 测试补充：QA AI
- 收口提交：小虾
```

#### Review 请求模板
```markdown
# Review 请求: [功能名称]

## 改动范围
[文件列表 + 改动说明]

## 架构影响
[是否影响现有架构]

## 测试覆盖
[已有测试 + 覆盖率]

## Review 重点
- [ ] 架构一致性
- [ ] 安全性
- [ ] 性能
- [ ] 可维护性

## Diff
[代码 diff]
```

#### QA 请求模板
```markdown
# 测试设计请求: [功能名称]

## 功能描述
[功能说明]

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

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

---

## 4. 配置步骤时间表

### Week 1 (本周)
- [x] 确认 Codex 作为主编码 AI
- [ ] 建立编码 AI 独立会话
- [ ] 建立 Review AI 独立会话
- [ ] 建立 QA AI 独立会话
- [ ] 补充 `CODING-STANDARD.md`
- [ ] 补充 `API-SPEC.md`
- [ ] 补充 `TESTING-GUIDE.md`

### Week 2
- [ ] 试运行：用一个小功能跑完整流程
- [ ] 调整协作模板
- [ ] 记录问题与改进

### Week 3+
- [ ] 正式启动 Phase 2
- [ ] 按需补充 UI AI 工具

---

## 5. 费用预算（粗估）

| 工具 | 月费 | 年费 | 备注 |
|------|------|------|------|
| Codex (OpenClaw) | 已有 | - | 主编码 AI |
| ChatGPT Plus | $20/月 | - | Review AI / QA AI |
| Claude Pro | $20/月 | - | Review AI / QA AI 备选 |
| v0 | $20/月 | - | Phase 2-3 再开通 |
| Figma Pro | $12/月 | - | 如需要 |
| Cursor Pro | $20/月 | - | 备选，如 Codex 不足时 |
| **合计（当前）** | **$0/月** | - | 使用已有工具 |

---

## 6. 验收标准

**AI 工具团队准备完成的标志**:
1. ✅ Cursor 能够按架构约束生成代码
2. ✅ Review AI 能够独立审查并给出建设性意见
3. ✅ QA AI 能够设计完整测试场景
4. ✅ 所有协作模板可用
5. ✅ 试运行一个小功能，流程顺畅

**下一步**:
- 正式启动 Phase 2 第一个功能
- 严格按分工制度执行
- 记录协作问题与改进

---

**更新时间**: 2026-06-15  
**负责人**: 小虾  
**审批**: 老大
