# 完整开发工作流示例

以「酷采3.0 标签管理模块」为例的完整需求生命周期。

## 第一步：创建需求

```bash
/req new 酷采3.0 商品标签管理模块
```

执行：`mcp__ai-proj__create_requirement` → 自动分配 display_id（如 REQ-2026-0006）

## 第二步：编写 PRD 文档

调用 `req-prd` 技能：
1. 创建 PRD 任务并关联到需求
2. 调用 `mcp__ai-proj__create-and-attach` 写入 PRD 文档

## 第三步：创建开发子任务

```python
# 创建子任务
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：数据模型设计")
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：Store/Biz实现")
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="后端：API Handler实现")
mcp__ai-proj__create_subtask(parentId=PRD任务ID, title="前端：页面开发")

# 批量关联到需求
mcp__ai-proj__link_tasks_to_requirement(requirementId=需求ID, taskIds=[...])
```

## 第四步：提交并审批需求

```bash
/req review          # draft → pending
/req review pass     # pending → approved
```

## 第五步：执行开发任务

```bash
/req dev REQ-2026-0006
```

按分层架构开发：Model → Store → Biz → Handler → Router

## 第六步：代码评审

```bash
/req cr REQ-2026-0006
```

开发完成后必须进行代码评审，评审通过后才能进入测试。

## 第七步：创建测试任务

```python
mcp__ai-proj__create_subtask(parentId=测试父任务, title="后端：单元测试")
mcp__ai-proj__create_subtask(parentId=测试父任务, title="后端：集成测试")
mcp__ai-proj__create_subtask(parentId=测试父任务, title="E2E：端到端测试")
mcp__ai-proj__create_subtask(parentId=测试父任务, title="UAT：用户验收测试")
```

## 第八步：执行测试

```bash
/req test REQ-2026-0006
```

按环境顺序：本机 → 预发布 → 生产

## 第九步：CI/CD 发布

```bash
/req deploy REQ-2026-0006 --env staging
```

## 第十步：完成归档

```bash
/req done REQ-2026-0006
```

自动生成需求生命周期总结文档，归档需求。

---

## 标准任务结构

```
需求: REQ-2026-XXXX
├── PRD 任务 (父任务，包含 PRD 文档)
│   ├── 后端：数据模型设计 (implementation)
│   ├── 后端：业务层实现 (implementation)
│   ├── 后端：API 实现 (implementation)
│   └── 前端：页面开发 (implementation)
│
├── 代码评审任务 (code_review) ← 必须步骤
│
├── 测试任务 (父任务)
│   ├── 单元测试 (test)
│   ├── 集成测试 (test)
│   ├── E2E测试 (test)
│   └── UAT验收 (test, 包含测试报告)
│
└── 发布任务 (父任务，包含发布记录)
    ├── Docker 镜像构建 (deploy)
    ├── 前端资源构建 (deploy)
    └── 部署到环境 (deploy)
```

## 5 阶段文档

| 序号 | 文档 | 阶段 |
|------|------|------|
| 01 | PRD | 需求定义 |
| 02 | 开发设计 | 开发实现 |
| 03 | 测试报告 | 测试验收 |
| 04 | 发布记录 | CI/CD部署 |
| 05 | 生命周期总结 | 归档 |