Xiaoxia AI
f27c036d70
- Codex as P0 main coding AI (already available) - Cursor downgraded to P2 backup - zero additional monthly cost - Week 1 checklist updated
316 lines
7.8 KiB
Markdown
316 lines
7.8 KiB
Markdown
# 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
|
||
**负责人**: 小虾
|
||
**审批**: 老大
|