kb-skills/.planning/REQUIREMENTS.md

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