openclaw/skills/dev-workflow/SKILL.md

---

name: dev-workflow description: "开始开发..." 时使用 - 多代理协作开发编排技能，解决单Agent开发的对话卡住和开发不完整问题

dev-workflow - 多代理协作开发编排

什么时候使用

当用户发送包含以下模式的消息时，此技能自动触发：

触发词	行为	示例
开始开发 + 描述	启动完整开发流程	"开始开发一个用户登录功能"
开始开发 + 项目类型	启动项目开发	"开始开发一个新的 kb-skill"

核心价值

通过多代理协作和分阶段编排，解决单Agent开发的两大痛点：

1. 对话卡住 — 长时间开发填满上下文窗口，质量下降
2. 开发不完整 — 缺乏系统性流程，遗漏边界情况或测试

9阶段流程

┌─────────────────────────────────────────────────────────────────┐
│  DEV-WORKFLOW PIPELINE                                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  阶段1: 头脑风暴                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 主Agent 通过问答澄清需求，直到足够进行完整开发            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段2: 方案设计 (3个子代理并行)                                 │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                          │
│  │ Agent A │ │ Agent B │ │ Agent C │                          │
│  │ 方案1   │ │ 方案2   │ │ 方案3   │                          │
│  └─────────┘ └─────────┘ └─────────┘                          │
│                          ↓                                      │
│  阶段3: 方案审核 (交叉审核)                                      │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ A审BC → B审AC → C审AB → 汇总 → 综合方案                  │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段4: 方案汇报                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 主Agent 汇报综合方案 → 用户决策 (批准/修改/重新设计)     │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段5: Spec编排                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 生成开发规格 → 分析任务依赖 → 分波执行计划               │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段6: 并行开发 (按波次执行)                                    │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ Wave 1: [Task1, Task2] 并行 → Wave 2: [Task3] → ...      │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段7: 测试                                                     │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 运行现有测试 + 运行生成测试 → 通过/失败(重试)            │   │
│  └─────────────────────────────────────────────────────────┘   │
│                          ↓                                      │
│  阶段8: 代码审查 (3个子代理并行)                                 │
│  ┌─────────┐ ┌─────────┐ ┌─────────┐                          │
│  │ Agent X │ │ Agent Y │ │ Agent Z │                          │
│  │ 完整审查│ │ 完整审查│ │ 完整审查│                          │
│  └─────────┘ └─────────┘ └─────────┘                          │
│                          ↓                                      │
│  阶段9: 修复验证                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │ 汇总问题 → 安排修复 → 验证子代理确认 → 汇报完成          │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

状态持久化

每个阶段完成后保存状态到 .planning/dev-workflow/state.json：

{
  "current_phase": 3,
  "current_stage": "方案设计",
  "started_at": "2026-03-09T18:00:00+08:00",
  "updated_at": "2026-03-09T19:30:00+08:00",
  "retry_count": 0,
  "phases": {
    "1": { "status": "completed", "data": {...} },
    "2": { "status": "completed", "data": {...} },
    "3": { "status": "in_progress", "agents": [...] }
  }
}

支持从任意阶段恢复继续。

失败处理

场景	处理方式
子代理失败	自动重试，最多3次
测试失败	自动重试，最多3次
审查发现问题	汇总后安排修复
超过3次重试	汇报用户等待决策

子代理配置

阶段	子代理数量	职责
方案设计	3	自由探索不同方案
方案审核	3	交叉审核其他方案
并行开发	N (按任务数)	执行开发任务
代码审查	3	独立完整审查
修复	N (按问题数)	修复发现的问题
验证	1	确认修复完成

汇报机制

每个阶段完成后向用户汇报：

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 DEV-WORKFLOW ► 阶段 X 完成
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

**阶段名称**: [阶段名称]
**状态**: ✓ 完成 / ⚠ 需要关注
**耗时**: [X分钟]

**成果摘要**:
- [成果1]
- [成果2]

**下一阶段**: [阶段名称]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

目录结构

.planning/dev-workflow/
├── state.json           # 当前状态
├── requirements.json    # 收集的需求
├── solutions/           # 方案设计
│   ├── solution-A.md
│   ├── solution-B.md
│   └── solution-C.md
├── reviews/             # 方案审核
│   ├── review-A.md
│   ├── review-B.md
│   └── review-C.md
├── final-solution.md    # 综合方案
├── spec.md              # 开发规格
├── execution-plan.md    # 执行计划
├── development/         # 开发过程
│   └── wave-1/
│       ├── task-1.json
│       └── task-2.json
├── test-results.json    # 测试结果
├── code-review/         # 代码审查
│   ├── review-X.md
│   ├── review-Y.md
│   └── review-Z.md
└── final-report.md      # 最终汇报

适用项目类型

类型	支持情况	说明
通用软件项目	✓ 完全支持	Python/JS/Go 等任意语言
kb-skills 技能	✓ 完全支持	Python + SKILL.md 规范
Web应用	✓ 完全支持	前后端分离项目
CLI工具	✓ 完全支持	命令行工具

执行流程

主Agent检测到触发词后：

1. 初始化状态文件 — 创建 .planning/dev-workflow/ 目录和 state.json
2. 进入阶段1 — 开始头脑风暴问答循环
3. 按流程执行 — 依次完成9个阶段
4. 每阶段汇报 — 完成后向用户汇报进度
5. 最终汇报 — 所有阶段完成后生成完整报告

恢复机制

如果会话中断：

1. 主Agent读取 state.json 获取当前状态
2. 根据状态恢复到对应阶段
3. 继续执行未完成的阶段
4. 保持所有已完成的成果

注意事项

• 主Agent不参与实际开发 — 保持编排者角色，避免上下文膨胀
• 方案必须用户确认 — 阶段4汇报后等待用户决策
• 测试必须通过 — 阶段7测试失败需修复后才能继续
• 审查问题必须处理 — 阶段9汇总所有问题并修复