starmen1265/kb-skills
Archived
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
This repository has been archived on 2026-08-07. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
f3398eda5f18e18c3f5f45b10baa95b8fff3b9c9
kb-skills/.planning/ROADMAP.md
T

6.8 KiB
Raw Blame History

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

Reference in New Issue View Git Blame Copy Permalink