starmen1265
e23b88c3fa
- PROJECT.md: 项目愿景和核心价值 - REQUIREMENTS.md: 21个v1需求 + 4个v2延期需求 - ROADMAP.md: 11阶段开发路线图 - STATE.md: 项目状态跟踪 - config.json: GSD工作流配置
3.8 KiB
3.8 KiB
dev-workflow
What This Is
一个多代理协作开发编排技能，解决单Agent开发时的两大痛点：对话上下文卡住、开发不完整。通过9阶段流程编排多个子代理并行工作，实现高质量、完整的软件开发。
主Agent作为编排者，不参与实际开发，而是协调多个专业子代理完成：需求澄清 → 方案设计 → 交叉审核 → 用户决策 → Spec编排 → 并行开发 → 测试验证 → 代码审查 → 修复验证。
Core Value
通过多代理协作和分阶段编排，确保开发任务完整、高质量地完成。
如果其他都失败，只要最终交付的代码是完整、可用的，这个技能就成功了。
Requirements
Validated
(None yet — ship to validate)
Active
- DW-01: 头脑风暴阶段 - 通过问答了解需求到足够进行完整开发
- DW-02: 方案设计阶段 - 安排3个子代理并行进行方案设计
- DW-03: 方案审核阶段 - 每个子代理审核其他两个方案，达成共识
- DW-04: 方案汇报阶段 - 主代理汇报最终方案，用户决策
- DW-05: Spec编排阶段 - 基于确认方案自动生成开发规格，编排并行任务
- DW-06: 并行开发阶段 - 多个子代理根据Spec并行开发
- DW-07: 测试阶段 - 运行现有测试 + 开发生成的新测试
- DW-08: 代码审查阶段 - 3个子代理独立完整审查代码
- DW-09: 修复验证阶段 - 汇总问题、安排修复、验证完成
- DW-10: 状态持久化 - 每阶段保存进度，支持跨会话继续
- DW-11: 每阶段汇报 - 每个阶段完成后向用户汇报进度
Out of Scope
- 单Agent开发模式 — 本技能必须使用多代理协作
- 跳过用户决策 — 方案必须经过用户确认才能进入开发
- 无限制重试 — 最多自动重试3次，超过必须汇报用户
Context
问题背景
当前单Agent开发存在两大问题：
- 对话卡住 — 长时间开发会填满上下文窗口，导致质量下降
- 开发不完整 — 缺乏系统性流程，容易遗漏边界情况或测试
解决思路
- 主Agent作为轻量编排者，保持上下文清爽
- 每个子代理独立上下文，专注单一任务
- 多代理交叉审核，提高方案和代码质量
- 分阶段保存状态，支持中断恢复
技术环境
- 技能框架：OpenClaw skills（SKILL.md 规范）
- 子代理：OpenClaw sessions_spawn（subagent runtime）
- 适用范围：通用软件项目 + kb-skills 技能开发
- 触发方式：关键词"开始开发..."
Constraints
- 子代理数量: 方案设计3个 + 代码审查3个 + 开发N个（按任务数）
- 重试上限: 最多3次自动重试，超过后汇报用户
- 上下文管理: 主Agent不参与实际开发，避免上下文膨胀
- 用户决策: 方案必须经用户确认，不能自动进入开发
Key Decisions
| Decision | Rationale | Outcome |
|---|---|---|
| 主Agent作为编排者 | 避免主Agent上下文膨胀，保持编排能力 | — Pending |
| 3个子代理方案设计 | 多样化方案，避免单一思路局限 | — Pending |
| 交叉审核方案 | 子代理互相审核，发现盲点 | — Pending |
| 自动生成Spec | 减少用户负担，基于确认方案自动编排 | — Pending |
| 现有测试+生成测试 | 双重保障，既有回归也有新增覆盖 | — Pending |
| 3个子代理独立审查 | 独立审查比分工审查发现更多问题 | — Pending |
| 依赖分析分波执行 | 自动处理任务依赖，最大化并行效率 | — Pending |
| 有限自动修复(3次) | 平衡自动化效率和用户控制 | — Pending |
| 每阶段保存状态 | 支持跨会话继续，不丢失进度 | — Pending |
| 每阶段汇报 | 用户始终了解进度，有干预机会 | — Pending |
Last updated: 2026-03-09 after initialization