# dev-workflow - Roadmap

## Milestone: v1.0 - Multi-Agent Development Orchestration

**Goal:** 完整的9阶段多代理协作开发流程，解决单Agent开发的对话卡住和开发不完整问题。

---

## Phase 1: 技能框架搭建

**Goal:** 创建技能基础结构，支持状态持久化和触发检测

**Requirements:** REQ-01, REQ-14, REQ-15, REQ-21

**Success Criteria:**
1. 用户说"开始开发..."时技能被触发
2. .planning/dev-workflow/ 目录可正常读写状态
3. 状态文件包含当前阶段、历史记录、恢复点
4. SKILL.md 符合 OpenClaw 技能规范

**Tasks:**
- [ ] 创建 dev-workflow/SKILL.md 主文档
- [ ] 定义触发词和技能描述
- [ ] 设计状态文件结构 (state.json)
- [ ] 实现状态保存/加载函数
- [ ] 实现阶段恢复逻辑

---

## Phase 2: 头脑风暴阶段

**Goal:** 通过问答澄清需求，直到信息足够进行完整开发

**Requirements:** REQ-02, REQ-16

**Success Criteria:**
1. 技能启动后进入问答循环
2. 每次提问针对性强，不重复
3. 收集信息包括：功能需求、技术栈、约束条件、验收标准
4. 用户可以随时说"够了"结束问答
5. 阶段结束时汇报收集到的需求摘要

**Tasks:**
- [ ] 设计问答策略（从宏观到微观）
- [ ] 实现需求信息收集模板
- [ ] 实现问答循环控制
- [ ] 实现需求摘要生成
- [ ] 保存头脑风暴结果到状态文件

---

## Phase 3: 方案设计阶段

**Goal:** 启动3个子代理并行设计方案

**Requirements:** REQ-03, REQ-16

**Success Criteria:**
1. 主代理正确启动3个独立的子代理
2. 每个子代理收到完整的上下文（需求、约束）
3. 子代理输出结构化方案文档
4. 主代理等待所有子代理完成后继续
5. 汇报3个方案的概要对比

**Tasks:**
- [ ] 设计子代理启动参数（prompt模板）
- [ ] 实现并行启动3个子代理
- [ ] 定义方案文档格式
- [ ] 实现子代理结果收集
- [ ] 生成方案对比摘要

---

## Phase 4: 方案审核阶段

**Goal:** 每个子代理审核其他两个方案，达成共识

**Requirements:** REQ-04, REQ-16

**Success Criteria:**
1. 每个子代理收到其他两个方案
2. 子代理输出审核意见（优点、缺点、建议）
3. 主代理汇总所有审核意见
4. 生成综合方案（融合各方案优点）
5. 保存综合方案到状态文件

**Tasks:**
- [ ] 设计方案审核prompt模板
- [ ] 实现交叉审核启动（A审BC，B审AC，C审AB）
- [ ] 定义审核意见格式
- [ ] 实现审核意见汇总
- [ ] 实现综合方案生成

---

## Phase 5: 方案汇报阶段

**Goal:** 向用户展示综合方案并获取决策

**Requirements:** REQ-05, REQ-16

**Success Criteria:**
1. 清晰展示综合方案的关键决策点
2. 用户可以选择：批准 / 修改 / 重新设计
3. 用户批准后进入Spec编排阶段
4. 用户修改意见被记录并反馈给方案阶段
5. 保存用户决策到状态文件

**Tasks:**
- [ ] 设计方案汇报格式
- [ ] 实现用户决策收集
- [ ] 处理"修改"反馈循环
- [ ] 处理"重新设计"回退
- [ ] 保存批准的方案

---

## Phase 6: Spec编排阶段

**Goal:** 基于确认方案生成开发规格，分析任务依赖，生成分波执行计划

**Requirements:** REQ-06, REQ-07, REQ-16

**Success Criteria:**
1. 从方案提取所有开发任务
2. 每个任务有清晰的输入、输出、验收标准
3. 分析任务间依赖关系
4. 生成分波执行计划（Wave 1, 2, 3...）
5. 同一波内任务可并行，不同波串行

**Tasks:**
- [ ] 设计Spec文档格式
- [ ] 实现方案→任务拆分
- [ ] 实现依赖分析算法
- [ ] 实现分波编排
- [ ] 生成执行计划文档

---

## Phase 7: 并行开发阶段

**Goal:** 启动多个子代理根据Spec并行开发

**Requirements:** REQ-08, REQ-16

**Success Criteria:**
1. 按波次启动子代理
2. 同一波内子代理并行执行
3. 每个子代理收到对应任务的完整上下文
4. 主代理监控子代理进度
5. 所有任务完成后汇报

**Tasks:**
- [ ] 实现按波次启动子代理
- [ ] 实现并行监控
- [ ] 处理子代理失败（重试逻辑）
- [ ] 收集开发结果
- [ ] 汇报开发进度

---

## Phase 8: 测试阶段

**Goal:** 运行现有测试 + 开发生成的新测试

**Requirements:** REQ-09, REQ-10, REQ-16, REQ-17, REQ-18

**Success Criteria:**
1. 检测并运行项目现有测试套件
2. 运行开发时生成的新测试
3. 测试通过则进入下一阶段
4. 测试失败则自动重试（最多3次）
5. 超过3次后汇报用户等待决策

**Tasks:**
- [ ] 检测项目测试框架
- [ ] 实现测试运行
- [ ] 解析测试结果
- [ ] 实现失败重试逻辑
- [ ] 实现用户介入机制

---

## Phase 9: 代码审查阶段

**Goal:** 启动3个子代理独立完整审查代码

**Requirements:** REQ-11, REQ-16

**Success Criteria:**
1. 启动3个独立的代码审查子代理
2. 每个子代理完整审查所有变更
3. 收集3个子代理的审查结果
4. 汇总问题列表（去重、分类）
5. 保存审查结果到状态文件

**Tasks:**
- [ ] 设计代码审查prompt模板
- [ ] 实现并行启动3个审查子代理
- [ ] 定义审查结果格式
- [ ] 实现问题汇总和分类
- [ ] 生成问题报告

---

## Phase 10: 修复验证阶段

**Goal:** 汇总问题、安排修复、验证完成

**Requirements:** REQ-12, REQ-13, REQ-16, REQ-17, REQ-18

**Success Criteria:**
1. 将问题分配给修复子代理
2. 修复完成后启动验证子代理
3. 验证通过则汇报用户完成
4. 验证失败则重试（最多3次）
5. 最终汇报包含：完成情况、遗留问题、后续建议

**Tasks:**
- [ ] 实现问题→修复任务分配
- [ ] 启动修复子代理
- [ ] 启动验证子代理
- [ ] 实现修复循环逻辑
- [ ] 生成最终汇报

---

## Phase 11: 集成测试

**Goal:** 端到端测试完整流程，确保技能可用

**Requirements:** REQ-19, REQ-20

**Success Criteria:**
1. 使用技能开发一个简单Python工具（通用项目）
2. 使用技能开发一个新kb-skill（技能项目）
3. 两个场景都完整走完9阶段
4. 生成的代码可运行、有测试、通过审查
5. 文档完整（SKILL.md）

**Tasks:**
- [ ] 设计测试场景1：简单CLI工具
- [ ] 执行测试场景1并记录问题
- [ ] 设计测试场景2：新kb-skill
- [ ] 执行测试场景2并记录问题
- [ ] 修复发现的问题

---

## Progress

| Phase | Status | Plans | Summaries |
|-------|--------|-------|-----------|
| 1 | ✓ Completed | 1/1 | 1/1 |
| 2 | ✓ Completed | 1/1 | 1/1 |
| 3 | ✓ Completed | 1/1 | 1/1 |
| 4 | ✓ Completed | 1/1 | 1/1 |
| 5 | ✓ Completed | 1/1 | 1/1 |
| 6 | ✓ Completed | 1/1 | 1/1 |
| 7 | ✓ Completed | 1/1 | 1/1 |
| 8 | ✓ Completed | 1/1 | 1/1 |
| 9 | ✓ Completed | 1/1 | 1/1 |
| 10 | ✓ Completed | 1/1 | 1/1 |
| 11 | Not Started | 0/1 | 0/1 |

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