ClawZone SDLC 工作流
适用范围：所有通过 ClawZone AI 团队开发的项目
版本：v1.0 | 更新：2026-03-07
工作流概览
开发阶段目标：开发 → 测试环境 → QA验收 → 测试环境交付
生产部署：独立规划，暂不纳入本流程
Phase 1：需求 Shaping
参与者： Tom + e50u（技术顾问）
产出： plan.md（存 GitLab，发布到 docs.clawzone.ai）
plan.md 必须包含：
- 需求背景 + 目标
- 技术方案（数据库设计、API 接口定义、核心逻辑）
- 验收标准 AC（逐条可 check，不能是描述性文字）
- RACI（谁负责什么）
- 工时估算
Phase 2：三方复核（DoD Gate）
参与者： Tom + e50u + kzzs
通过条件：
- 需求无歧义
- 架构可行（数据模型、接口契约确定）
- AC 可验证
- 执行任务可拆解
不通过 → 退回 Shaping，不进开发。
Phase 3：开发
执行者： AI 子 agent（基于 plan.md）
规范：
- 每个任务单独分支（feat/xxx），不直接推 main
- 代码包含单元测试
- MR 描述关联 plan.md 对应的 AC 编号
Phase 4：CI 自动门控（merge 前）
GitLab CI 执行：
- 单元测试通过 ✅
- Build 成功 ✅
- 代码风格检查 ✅
门控不通过 → 不允许 merge，子 agent 修复后重跑。
Phase 5：自动部署到测试环境
触发： MR 合并到 main
执行： GitLab CI 自动 deploy 到测试环境
测试环境： 独立 Docker 容器，136.110.72.111，子域名 test.clawzone.ai
部署完成后： 自动通知 e50u 开始 QA
Phase 6：QA 验收
执行者： e50u
流程：
- 收到通知，读取 plan.md 的 AC 列表
- 逐条在测试环境验证
- 出验收报告：✅ 通过 / ❌ 不通过（附具体问题）
不通过 → 退回开发，修复后重新触发 CI + 部署 + QA。
Phase 7：交付（测试环境）
执行者： Tom 最终确认
动作：
- Review e50u 验收报告
- 确认交付 → 更新项目状态为 ✅
- 记录 changelog + lessons learned
- 下一个项目出 Backlog
角色分工
| 角色 | 承担者 | 职责 |
|---|---|---|
| 产品决策 | Tom | 需求优先级、最终验收确认 |
| 技术顾问 | e50u | Shaping、方案设计、QA 验收 |
| 主协调 | kzzs | 流程推进、任务分发、进度同步 |
| 开发执行 | AI 子 agent | 按 plan.md 编写代码 |
基础设施依赖
| 组件 | 状态 |
|---|---|
| 测试环境（test.clawzone.ai） | 🔲 待建 |
| GitLab CI 流水线 | 🔲 待建 |
| QA 自动通知机制 | 🔲 待建 |
| e50u 验收 SOP | 🔲 待完善 |
| plan.md 模板（含 AC 规范） | 🔲 待更新 |