docs: initialize dev-workflow project with GSD

- PROJECT.md: 项目愿景和核心价值 - REQUIREMENTS.md: 21个v1需求 + 4个v2延期需求 - ROADMAP.md: 11阶段开发路线图 - STATE.md: 项目状态跟踪 - config.json: GSD工作流配置
2026-03-09 18:54:17 +08:00
parent 3850bc33dc
commit e23b88c3fa
5 changed files with 500 additions and 0 deletions
@@ -0,0 +1,86 @@
+# 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*
@@ -0,0 +1,77 @@
+# dev-workflow - Requirements
+
+## v1 Requirements
+
+### Core Pipeline
+
+| ID | Requirement | Priority |
+|----|-------------|----------|
+| REQ-01 | 用户说"开始开发..."时自动触发技能 | Must |
+| REQ-02 | 头脑风暴阶段通过问答澄清需求，直到足够开发 | Must |
+| REQ-03 | 方案设计阶段启动3个子代理并行设计 | Must |
+| REQ-04 | 方案审核阶段每个子代理审核其他两个方案 | Must |
+| REQ-05 | 方案汇报阶段向用户展示方案并获取决策 | Must |
+| REQ-06 | Spec编排阶段基于确认方案生成开发规格 | Must |
+| REQ-07 | Spec编排阶段分析任务依赖，生成分波执行计划 | Must |
+| REQ-08 | 并行开发阶段启动多个子代理执行任务 | Must |
+| REQ-09 | 测试阶段运行项目现有测试套件 | Must |
+| REQ-10 | 测试阶段运行开发时生成的新测试 | Must |
+| REQ-11 | 代码审查阶段启动3个子代理独立完整审查 | Must |
+| REQ-12 | 修复验证阶段汇总问题并安排修复 | Must |
+| REQ-13 | 修复验证阶段启动验证子代理确认完成 | Must |
+
+### State & Control
+
+| ID | Requirement | Priority |
+|----|-------------|----------|
+| REQ-14 | 每阶段完成后保存状态到 .planning/dev-workflow/ | Must |
+| REQ-15 | 支持从任意阶段恢复继续 | Must |
+| REQ-16 | 每阶段完成后向用户汇报进度 | Must |
+| REQ-17 | 失败时自动重试，最多3次 | Must |
+| REQ-18 | 超过3次重试后汇报用户等待决策 | Must |
+
+### Integration
+
+| ID | Requirement | Priority |
+|----|-------------|----------|
+| REQ-19 | 支持开发通用软件项目 | Must |
+| REQ-20 | 支持开发 kb-skills 技能（Python + SKILL.md） | Must |
+| REQ-21 | 与 OpenClaw sessions_spawn 子代理系统集成 | Must |
+
+## v2 Requirements (Deferred)
+
+| ID | Requirement | Reason |
+|----|-------------|--------|
+| REQ-22 | 支持自定义子代理数量 | 保持简单，先固定3个 |
+| REQ-23 | 支持自定义审查维度 | 先用独立完整审查 |
+| REQ-24 | 支持多种触发词配置 | 先固定"开始开发" |
+| REQ-25 | 生成开发报告文档 | 先专注核心流程 |
+
+## Out of Scope
+
+| Exclusion | Reason |
+|-----------|--------|
+| 单Agent模式 | 本技能核心价值就是多代理协作 |
+| 跳过用户决策 | 方案必须经用户确认，避免错误方向 |
+| 无限重试 | 需要用户介入机制，防止无限循环 |
+| 实时进度流 | 先用每阶段汇报，后续可优化 |
+| Web UI | 纯命令行/聊天交互 |
+
+## Traceability
+
+| Phase | Requirements |
+|-------|--------------|
+| Phase 1: 技能框架搭建 | REQ-01, REQ-14, REQ-15, REQ-21 |
+| Phase 2: 头脑风暴阶段 | REQ-02, REQ-16 |
+| Phase 3: 方案设计阶段 | REQ-03, REQ-16 |
+| Phase 4: 方案审核阶段 | REQ-04, REQ-16 |
+| Phase 5: 方案汇报阶段 | REQ-05, REQ-16 |
+| Phase 6: Spec编排阶段 | REQ-06, REQ-07, REQ-16 |
+| Phase 7: 并行开发阶段 | REQ-08, REQ-16 |
+| Phase 8: 测试阶段 | REQ-09, REQ-10, REQ-16, REQ-17, REQ-18 |
+| Phase 9: 代码审查阶段 | REQ-11, REQ-16 |
+| Phase 10: 修复验证阶段 | REQ-12, REQ-13, REQ-16, REQ-17, REQ-18 |
+| Phase 11: 集成测试 | REQ-19, REQ-20 |
+
+---
+*Last updated: 2026-03-09*
@@ -0,0 +1,267 @@
+# 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 | Not Started | 0/1 | 0/1 |
+| 2 | Not Started | 0/1 | 0/1 |
+| 3 | Not Started | 0/1 | 0/1 |
+| 4 | Not Started | 0/1 | 0/1 |
+| 5 | Not Started | 0/1 | 0/1 |
+| 6 | Not Started | 0/1 | 0/1 |
+| 7 | Not Started | 0/1 | 0/1 |
+| 8 | Not Started | 0/1 | 0/1 |
+| 9 | Not Started | 0/1 | 0/1 |
+| 10 | Not Started | 0/1 | 0/1 |
+| 11 | Not Started | 0/1 | 0/1 |
+
+---
+*Last updated: 2026-03-09*
@@ -0,0 +1,57 @@
+---
+phase: 0
+stage: initialized
+milestone: v1.0
+started: 2026-03-09T18:52:00+08:00
+updated: 2026-03-09T18:52:00+08:00
+retry_count: 0
+---
+
+# dev-workflow - State
+
+## Current Position
+
+**Status:** Initialized
+**Phase:** 0 (Project Setup)
+**Next Step:** Phase 1 - 技能框架搭建
+
+## Project Reference
+
+See: .planning/PROJECT.md (updated 2026-03-09)
+
+**Core value:** 通过多代理协作和分阶段编排，确保开发任务完整、高质量地完成。
+**Current focus:** 技能框架搭建
+
+## Phase History
+
+| Phase | Status | Started | Completed | Notes |
+|-------|--------|---------|-----------|-------|
+| 0 | ✓ Complete | 2026-03-09 | 2026-03-09 | 项目初始化，需求收集完成 |
+
+## Active Decisions
+
+| Decision | Made On | Context |
+|----------|---------|---------|
+| 触发词："开始开发..." | 2026-03-09 | 用户确认 |
+| 3个子代理方案设计 | 2026-03-09 | 子代理自由探索 |
+| 交叉审核方案 | 2026-03-09 | 每个审核其他两个 |
+| 自动生成Spec | 2026-03-09 | 基于确认方案 |
+| 现有测试+生成测试 | 2026-03-09 | 双重保障 |
+| 3个子代理独立审查 | 2026-03-09 | 完整审查 |
+| 依赖分析分波执行 | 2026-03-09 | 自动处理依赖 |
+| 有限自动修复(3次) | 2026-03-09 | 平衡效率和控制 |
+| 每阶段保存状态 | 2026-03-09 | 支持跨会话 |
+| 每阶段汇报 | 2026-03-09 | 用户始终了解进度 |
+
+## Blockers
+
+(None)
+
+## Notes
+
+- 9阶段流程已定义
+- 11个开发阶段已规划
+- 需要与 OpenClaw sessions_spawn 集成
+
+---
+*This file tracks project state across sessions. Updated automatically by GSD workflow.*
@@ -0,0 +1,13 @@
+{
+  "mode": "interactive",
+  "granularity": "standard",
+  "parallelization": true,
+  "commit_docs": true,
+  "model_profile": "balanced",
+  "workflow": {
+    "research": true,
+    "plan_check": true,
+    "verifier": true,
+    "nyquist_validation": true
+  }
+}