xiaoxia/xiaoxia-saas
1
0
Fork 0
Code Issues 11 Pull Requests 2 Actions Packages Projects Releases 7 Wiki Activity
Files
acadc2bcba3a5dfd46105b7bb370c0be2ef8f759
xiaoxia-saas/docs/AI-TOOLS-PREPARATION.md
T
Xiaoxia AI f27c036d70 docs: update AI tools - use Codex as primary coding AI 
- Codex as P0 main coding AI (already available)
- Cursor downgraded to P2 backup
- zero additional monthly cost
- Week 1 checklist updated
2026-06-15 16:14:23 +08:00

7.8 KiB
Raw Blame History

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 协作模板

任务分配模板

# 任务: [功能名称]

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

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

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

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

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

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

Review 请求模板

# Review 请求: [功能名称]

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

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

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

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

## Diff
[代码 diff]

QA 请求模板

# 测试设计请求: [功能名称]

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

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

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

4. 配置步骤时间表

Week 1 (本周)

  • 确认 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
负责人: 小虾
审批: 老大

Reference in New Issue View Git Blame Copy Permalink