Files
xiaoxia-saas/docs/ai-team-tooling-checklist.md
T
Xiaoxia AI b5a62ee9a3 feat: initial SaaS scaffold
- domain: User, Workspace, Project, AssetLibrary, Asset, IngestJob
- ports: repository interfaces
- application: use cases
- adapters: in-memory
- API: FastAPI 5 routes
- worker: Celery ingest_asset
- tests: 4 passing
2026-06-15 15:17:40 +08:00

282 lines
5.4 KiB
Markdown

# AI 团队工具清单(第一版)
本文档定义新 SaaS 项目启动阶段需要的 AI 工具、用途、角色归属、优先级、获取方式和安全要求。
---
## 1. 总原则
我们不自研 AI 平台,前期采用:
- 现成模型服务
- 现成 AI IDE / AI 设计工具
- 明确角色分工
- 统一输入输出规范
重点不是“工具越多越好”,而是:
- 谁负责什么
- 谁来拍板
- 谁来 review
- 谁来回归
- 所有 AI 是否围绕统一文档工作
---
## 2. 工具分类
AI 工具分为 5 类:
1. 通用大模型
2. 编码工具
3. UI / 原型工具
4. Review / QA 工具
5. 协作与知识工具
---
## 3. 工具清单
| 类别 | 工具 | 主要用途 | 主要使用者 | 优先级 | 获取方式 |
|------|------|----------|------------|--------|----------|
| 通用大模型 | ChatGPT | 需求整理、方案讨论、文档草稿、总结 | 老大 / 小虾 | P0 | 直接订阅 |
| 通用大模型 | Claude | 长文分析、架构讨论、文档、审查建议 | 老大 / 小虾 | P0 | 直接订阅 |
| 编码工具 | Codex / Codex CLI | 仓库修改、重构、补测试、代码执行 | 小虾 / 编码 AI | P0 | 已可用 / 订阅 |
| 编码工具 | Cursor | 前后端模块实现、快速编码 | 编码 AI | P0 | 直接订阅 |
| 编码工具 | Claude Code / 同类 | 代码实现、重构、排错 | 编码 AI | P1 | 按需开通 |
| UI / 原型 | Figma | 页面结构、流程图、组件设计 | 老大 / UI AI | P0 | 直接订阅 |
| UI / 原型 | Figma AI | 辅助出界面和文案 | UI AI | P1 | Figma 内能力 |
| UI / 原型 | v0 | Web 页面草图、组件原型 | UI AI / 前端 AI | P1 | 直接开通 |
| UI / 原型 | Lovable | 页面快速原型 | UI AI | P2 | 按需开通 |
| Review / QA | 独立大模型会话 | 代码审查、架构偏离检查 | Review AI | P0 | 基于已有模型 |
| Review / QA | 独立大模型会话 | 测试设计、回归建议、bug 复盘 | QA AI | P0 | 基于已有模型 |
| 协作 / 知识 | Gitea | 代码真相源、Issue、PR/提交记录 | 全员 | P0 | 已有 |
| 协作 / 知识 | CI/CD | 自动检查、构建、测试、部署 | 全员 | P0 | 已有基础,需重建 |
| 协作 / 知识 | 巡检机器人 | 线上状态、异常巡检、告警 | 运维 / 小虾 | P1 | 已有基础 |
---
## 4. 按角色分配
### 4.1 老大
负责:
- 目标
- 产品边界
- 风格偏好
- 最终拍板
建议直接使用:
- ChatGPT
- Claude
- Figma
### 4.2 小虾(技术负责人 / 总协调)
负责:
- 架构方案
- 拆解任务
- 规范约束
- 合并口径
- 收口
建议直接使用:
- ChatGPT / Claude
- Codex / Codex CLI
- Gitea
- CI/CD
### 4.3 编码 AI
负责:
- 具体模块实现
- 前端编码
- 后端编码
- 补测试
建议直接使用:
- Codex / Codex CLI
- Cursor
- Claude Code / 同类
### 4.4 UI AI
负责:
- 页面结构
- 交互流
- 原型草图
- 视觉辅助
建议直接使用:
- Figma
- Figma AI
- v0
- Lovable
### 4.5 Review AI
负责:
- 代码审查
- 架构一致性检查
- 风险提示
- 边界偏移检查
建议直接使用:
- 独立 ChatGPT / Claude 会话
- 仓库 diff / PR 内容
### 4.6 QA / Bug AI
负责:
- 复现问题
- 补回归场景
- 测试建议
- bug 分类
建议直接使用:
- 独立 ChatGPT / Claude 会话
- CI 报告
- 日志与监控结果
---
## 5. 获取顺序
### 第一批:马上需要
必须先具备:
1. ChatGPT
2. Claude
3. Cursor 或同类编码 AI IDE
4. Figma
5. Gitea
6. CI/CD 基础
### 第二批:开始进入前端原型和多人协作时补
1. v0
2. Figma AI
3. 独立 Review / QA 会话模板
4. 巡检机器人 SaaS 化巡检能力
### 第三批:规模扩大后再补
1. 更专业的设计协同工具
2. 更完整的测试平台
3. 更高级的知识库 / 检索增强能力
---
## 6. 采购 / 开通制度
### 6.1 原则
- 优先采购真正高频使用的工具
- 一个角色至少有一套稳定主工具
- 前期不堆太多重复工具
- 所有付费工具要登记账号归属和用途
### 6.2 必须登记的信息
每个工具都要记录:
- 工具名称
- 购买渠道
- 账号归属
- 谁可以使用
- 费用周期
- 主要用途
- 替代方案
---
## 7. 安全制度
### 7.1 严禁随意喂给 AI 的信息
- 服务器 root 密码
- 数据库密码
- 云存储密钥
- 支付相关密钥
- 生产环境敏感配置
- 用户隐私数据
### 7.2 可以给 AI 的信息
- 脱敏代码
- 架构方案
- 伪造样本数据
- 通用错误日志(脱敏后)
- 接口设计草稿
### 7.3 最佳实践
- 敏感配置统一放环境变量和密钥管理中
- 给外部 AI 前先脱敏
- 不把完整生产数据库导出直接发给任何模型
---
## 8. 使用制度
### 制度 1:一个问题一个 owner
- 架构问题只由技术 owner 收口
- UI 问题由 UI owner 收口
- Review 不能和编码混同
### 制度 2:AI 输出不能直接上线
必须经过:
- 人工确认
- 代码审查
- 自动化测试
- CI 通过
### 制度 3:统一文档源
所有 AI 都必须围绕同一套文档:
- PRD
- 架构文档
- 数据模型
- API 规范
- 任务拆解清单
### 制度 4:避免多 AI 同时乱改同一问题
- 一个任务一个主执行者
- 其他 AI 提供辅助,不直接平行乱改
---
## 9. 当前结论
当前最值得立即准备的 AI 工具是:
- ChatGPT
- Claude
- Codex / Codex CLI
- Cursor
- Figma
- Gitea
- CI/CD
这些足够支撑新 SaaS 项目从 0 到可开发启动。
后续再按阶段补更细的 UI / Review / QA 工具。