268 lines
6.8 KiB
Markdown
268 lines
6.8 KiB
Markdown
# 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*
|