从想法到实现计划
本文档定义了一个工作流,通过迭代细化单个 Markdown 文档,将模糊想法转化为清晰的实现计划。
核心原则
- •迭代细化: 逐阶段推进,每次更新一个部分
- •用户协作: 每个阶段需要用户明确审查和确认后再继续
- •结构化输出: 所有工作捕获在单一、结构良好的 Markdown 文件中
Markdown 文件结构
管理包含以下 H2 标题的单个 .md 文件:
- •
## Idea: 初始概念 - •
## Requirements: 功能和非功能需求及验收标准 - •
## Tasks: 详细、可操作的工作分解 - •
## Design: 高级技术设计和组件结构 - •
## Test Cases: 验证实现的场景 - •
## Next Steps: 即时行动摘要
工作流阶段
1. 想法 → 需求
- •目标: 将初始想法转化为清晰、可验证的需求
- •流程:
- •在
## Idea部分捕获用户想法 - •提出澄清问题解决歧义
- •在
## Requirements下起草具有 Given-When-Then 验收标准的具体需求 - •请求用户审查和确认
- •在
2. 需求 → 任务
- •目标: 将需求分解为细粒度、可操作的任务列表
- •流程:
- •分析已批准的需求
- •按以下原则在
## Tasks部分分解:- •MECE: 任务必须相互独立且完全穷尽
- •明确目标与交付物: 每个子任务必须有精确定义的目标和可验证的预期交付物
- •可管理规模: 将任务分解为足够小的块
- •优先级: 考虑业务价值、依赖关系和风险
- •独立性: 争取可独立工作和测试的子任务
- •可验证性: 设计可清晰验证完成的子任务
- •请求用户审查和确认
3. 任务 → 设计
- •目标: 创建技术设计规范
- •流程:
- •分析已批准的任务
- •在
## Design部分提出设计,包括类、方法和关系(鼓励使用 Mermaid 图表) - •确保设计考虑现有架构和质量标准
- •请求用户审查和确认
4. 设计 → 测试用例
- •目标: 定义全面的测试用例集
- •流程:
- •分析已批准的设计
- •在
## Test Cases下定义测试用例(正面、负面、边界) - •确保需求的完整覆盖
- •在
## Next Steps添加实现建议 - •请求用户审查和确认
执行指导(规划分析师模式)
当进行规划任务时,按以下流程执行:
阶段转换引导
code
想法 → 需求 → 任务 → 设计 → 测试用例
↑ ↑ ↑ ↑
澄清问题 MECE分解 架构设计 覆盖验证
执行检查清单
| 阶段 | 关键动作 | 用户交互 |
|---|---|---|
| 想法→需求 | 提问澄清歧义 | 等待确认 |
| 需求→任务 | MECE 分解 | 等待确认 |
| 任务→设计 | 绘制架构图 | 等待确认 |
| 设计→测试 | 定义验证场景 | 等待确认 |
触发条件
- •用户提出新想法或功能请求
- •需求分析任务
- •项目规划讨论
- •技术方案设计
关键原则
- •用户协作: 每个阶段必须等待用户确认
- •单一文档: 所有产出集中在一个 Markdown 文件
- •迭代细化: 允许回退修正,但保持结构化进展
- •MECE 分解: 任务必须相互独立、完全穷尽