# dev-workflow - Requirements

## v1 Requirements

### Core Pipeline

| ID | Requirement | Priority |
|----|-------------|----------|
| REQ-01 | 用户说"开始开发..."时自动触发技能 | Must |
| REQ-02 | 头脑风暴阶段通过问答澄清需求，直到足够开发 | Must |
| REQ-03 | 方案设计阶段启动3个子代理并行设计 | Must |
| REQ-04 | 方案审核阶段每个子代理审核其他两个方案 | Must |
| REQ-05 | 方案汇报阶段向用户展示方案并获取决策 | Must |
| REQ-06 | Spec编排阶段基于确认方案生成开发规格 | Must |
| REQ-07 | Spec编排阶段分析任务依赖，生成分波执行计划 | Must |
| REQ-08 | 并行开发阶段启动多个子代理执行任务 | Must |
| REQ-09 | 测试阶段运行项目现有测试套件 | Must |
| REQ-10 | 测试阶段运行开发时生成的新测试 | Must |
| REQ-11 | 代码审查阶段启动3个子代理独立完整审查 | Must |
| REQ-12 | 修复验证阶段汇总问题并安排修复 | Must |
| REQ-13 | 修复验证阶段启动验证子代理确认完成 | Must |

### State & Control

| ID | Requirement | Priority |
|----|-------------|----------|
| REQ-14 | 每阶段完成后保存状态到 .planning/dev-workflow/ | Must |
| REQ-15 | 支持从任意阶段恢复继续 | Must |
| REQ-16 | 每阶段完成后向用户汇报进度 | Must |
| REQ-17 | 失败时自动重试，最多3次 | Must |
| REQ-18 | 超过3次重试后汇报用户等待决策 | Must |

### Integration

| ID | Requirement | Priority |
|----|-------------|----------|
| REQ-19 | 支持开发通用软件项目 | Must |
| REQ-20 | 支持开发 kb-skills 技能（Python + SKILL.md） | Must |
| REQ-21 | 与 OpenClaw sessions_spawn 子代理系统集成 | Must |

## v2 Requirements (Deferred)

| ID | Requirement | Reason |
|----|-------------|--------|
| REQ-22 | 支持自定义子代理数量 | 保持简单，先固定3个 |
| REQ-23 | 支持自定义审查维度 | 先用独立完整审查 |
| REQ-24 | 支持多种触发词配置 | 先固定"开始开发" |
| REQ-25 | 生成开发报告文档 | 先专注核心流程 |

## Out of Scope

| Exclusion | Reason |
|-----------|--------|
| 单Agent模式 | 本技能核心价值就是多代理协作 |
| 跳过用户决策 | 方案必须经用户确认，避免错误方向 |
| 无限重试 | 需要用户介入机制，防止无限循环 |
| 实时进度流 | 先用每阶段汇报，后续可优化 |
| Web UI | 纯命令行/聊天交互 |

## Traceability

| Phase | Requirements |
|-------|--------------|
| Phase 1: 技能框架搭建 | REQ-01, REQ-14, REQ-15, REQ-21 |
| Phase 2: 头脑风暴阶段 | REQ-02, REQ-16 |
| Phase 3: 方案设计阶段 | REQ-03, REQ-16 |
| Phase 4: 方案审核阶段 | REQ-04, REQ-16 |
| Phase 5: 方案汇报阶段 | REQ-05, REQ-16 |
| Phase 6: Spec编排阶段 | REQ-06, REQ-07, REQ-16 |
| Phase 7: 并行开发阶段 | REQ-08, REQ-16 |
| Phase 8: 测试阶段 | REQ-09, REQ-10, REQ-16, REQ-17, REQ-18 |
| Phase 9: 代码审查阶段 | REQ-11, REQ-16 |
| Phase 10: 修复验证阶段 | REQ-12, REQ-13, REQ-16, REQ-17, REQ-18 |
| Phase 11: 集成测试 | REQ-19, REQ-20 |

---
*Last updated: 2026-03-09*