starmen1265
e23b88c3fa
- PROJECT.md: 项目愿景和核心价值 - REQUIREMENTS.md: 21个v1需求 + 4个v2延期需求 - ROADMAP.md: 11阶段开发路线图 - STATE.md: 项目状态跟踪 - config.json: GSD工作流配置
87 lines
3.8 KiB
Markdown
87 lines
3.8 KiB
Markdown
# 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开发存在两大问题：
|
||
1. **对话卡住** — 长时间开发会填满上下文窗口，导致质量下降
|
||
2. **开发不完整** — 缺乏系统性流程，容易遗漏边界情况或测试
|
||
|
||
### 解决思路
|
||
|
||
- 主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*
|