name: dev-workflow-planning description: 使用 /brainstorm、/write-plan 和 /execute-plan 模式的结构化开发工作流程。将临时对话转化为系统化的项目执行，采用假设驱动规划、增量实现和进度跟踪。
工作流程规划技能 - 快速参考
此技能支持结构化、系统化的开发工作流程。当用户需要分解复杂项目、创建实施计划或执行具有明确检查点的多步骤开发任务时，助手应应用这些模式。
灵感来源：Obra Superpowers 的结构化代理工作流程模式。
快速参考
| 命令 | 目的 | 使用时机 |
|---|---|---|
/brainstorm |
生成想法和方法 | 启动新功能、探索解决方案 |
/write-plan |
创建详细的实施计划 | 编码前、需求澄清后 |
/execute-plan |
逐步实施计划 | 计划批准后、准备编码时 |
/checkpoint |
审查进度、调整计划 | 实施中期、重大里程碑后 |
/summarize |
捕获学习、记录决策 | 会话结束前、上下文重置前 |
何时使用此技能
当用户请求时，助手应调用此技能：
- 将复杂功能分解为步骤
- 创建实施计划
- 头脑风暴问题解决方案
- 执行多步骤开发任务
- 跟踪项目进度
- 审查并调整实施中期
三阶段工作流程
第一阶段：头脑风暴
目的：探索问题空间并生成潜在解决方案。
/brainstorm [主题或问题]
输出：
1. 问题理解
- 我们解决什么？
- 谁受影响？
- 约束条件是什么？
2. 潜在方法（3-5个）
- 方法 A：[描述、优点、缺点]
- 方法 B：[描述、优点、缺点]
- 方法 C：[描述、优点、缺点]
3. 待解决问题
- [需要澄清的未知列表]
4. 推荐方法
- [选择的方法及理由]
第二阶段：编写计划
目的：创建详细、可操作的实施计划。
/write-plan [功能或任务]
输出：
## 实施计划：[功能名称]
### 目标
[描述结果的单句]
### 成功标准
- [ ] 标准 1
- [ ] 标准 2
- [ ] 标准 3
### 步骤（带估计）
#### 步骤 1：[名称]（~X小时）
- 什么：[具体操作]
- 文件：[要修改/创建的文件]
- 依赖项：[必须先存在的内容]
- 验证：[如何确认完成]
#### 步骤 2：[名称]（~X小时）
...
### 风险与缓解措施
| 风险 | 可能性 | 影响 | 缓解措施 |
|------|-----------|--------|------------|
| 风险 1 | 中等 | 高 | 如果...则采用计划 B |
### 开放问题
- [开始前需解决的问题]
第三阶段：执行计划
目的：通过检查点系统化地实施计划。
/execute-plan [计划参考]
执行模式：
1. 加载计划
2. 对每个步骤：
a. 宣布：“开始步骤 X：[名称]”
b. 执行操作
c. 验证完成
d. 报告：“步骤 X 完成。[简要摘要]”
3. 完成后：
a. 运行所有验证标准
b. 报告最终状态
结构化模式
假设驱动开发
模式：在提交前测试假设
实施前：
1. 陈述假设：“如果我们[操作]，那么[预期结果]”
2. 定义实验：“为了测试，我们将[最小化测试]”
3. 执行实验
4. 评估：“假设确认/拒绝，因为[证据]”
5. 基于结果继续或转向
增量实现
模式：以可验证的增量构建
对于复杂功能：
1. 识别最小可测试单元
2. 实施并验证
3. 逐步扩大范围
4. 每次扩大时验证
5. 集成并验证整体
示例：
功能：用户认证
- 增量 1：基本登录表单（无后端）
- 增量 2：API 端点（硬编码响应）
- 增量 3：数据库集成
- 增量 4：会话管理
- 增量 5：密码重置流程
进度跟踪
模式：保持可见进度
每次操作后：
[X] 步骤 1：创建数据库模式
[X] 步骤 2：实现 API 端点
[进行中] 步骤 3：添加前端表单
[ ] 步骤 4：编写测试
[ ] 步骤 5：部署到预发布环境
当前：第 3 步/共 5 步（完成 60%）
阻碍：无
下一步：完成表单验证
在制品（WIP）限制
模式：限制并发工作以改进流程
WIP 限制限制每个工作流程阶段的最大项目数。
好处：使阻碍可见，减少上下文切换，通常提高吞吐量。
推荐限制：
| 级别 | 限制 | 理由 |
|-------|-------|-----------|
| 个人 | 2-3 个任务 | 最小化上下文切换 |
| 团队（故事） | 团队规模 + 1 | 允许配对而不阻塞 |
| 进行中列 | 3-5 个项目 | 在开始前强制完成 |
| 代码审查 | 2-3 个 PR | 防止审查瓶颈 |
设置 WIP 限制：
1. 从团队规模 + 1 开始
2. 监控 2-4 周
3. 如果限制从未达到 -> 降低限制
4. 如果持续阻塞 -> 调查瓶颈，不要提高限制
5. 基于实际流程数据调整
何时（慎重）违反：
- 紧急生产修复
- 解锁另一团队
- 记录例外并在回顾中审查
会话管理
启动会话
会话已初始化。
- 项目：[名称]
- 目标：[今日目标]
- 已加载上下文：[文件、先前决策]
- 计划状态：[剩余步骤]
准备从：[上一个检查点] 继续
结束会话
/summarize
输出：
## 会话摘要
### 已完成
- [已完成项目列表]
### 进行中
- [未完成工作的当前状态]
### 已做决策
- [关键决策及理由]
### 下一次会话
- [ ] [下一次的第一个任务]
- [ ] [第二个任务]
### 要保留的上下文
[连续性的关键信息]
决策框架
面临选择时：
1. 清晰陈述决策
2. 列出选项（2-4 个）
3. 对每个选项：
- 优点
- 缺点
- 努力估计
- 风险级别
4. 推荐并说明理由
5. 可逆性评估
示例：
决策：如何实施认证？
| 选项 | 优点 | 缺点 | 努力 | 风险 |
|--------|------|------|--------|------|
| JWT | 无状态、可扩展 | 令牌管理 | 2 天 | 低 |
| 会话 | 简单、安全 | 服务器状态 | 1 天 | 低 |
| 仅 OAuth | 无密码 | 外部依赖 | 3 天 | 中等 |
推荐：MVP 使用会话，计划扩展时迁移到 JWT。
与其他技能集成
与测试技能
/write-plan 与 TDD：
步骤 1：编写失败测试
步骤 2：实现最简代码
步骤 3：验证测试通过
步骤 4：重构
步骤 5：添加边缘案例测试
与架构技能
/brainstorm 系统设计：
1. 需求澄清
2. 组件识别
3. 接口定义
4. 数据流映射
5. 实施计划
准备就绪/完成定义（DoR/DoD）
assets/template-dor-dod.md - 工作准备和完成的检查清单。
assets/template-work-item-ticket.md - 带 DoR/DoD 和可测试验收标准的工单模板。
关键部分
- 准备就绪定义 - 用户故事、错误、技术任务检查清单
- 完成定义 - 功能、错误修复、探针完成标准
- 验收标准模板 - Gherkin（给定/当/那么）、项目符号列表、基于规则
- 估计指南 - 故事点参考尺度（1-21+）、切片策略
- 规划级别 - 路线图 -> 里程碑 -> 冲刺 -> 任务层次结构
- 跨职能协调 - RACI 矩阵、交接检查清单
做/避免
好：做
- 在拉入冲刺前检查 DoR
- 在标记完成前验证 DoD
- 使用参考尺度估算故事规模
- 切片大故事（>8 点）
- 提前记录验收标准
- 在估计中包含风险缓冲
- 明确协调交接
坏：避免
- 在没有明确验收标准的情况下开始工作
- 未经测试就宣布“完成”
- 不理解范围就估计
- 处理太大无法在冲刺中完成的故事
- 跳过代码审查以“节省时间”
- 未经预发布环境验证就部署
- 假设交接自动发生
反模式
| 反模式 | 问题 | 修复 |
|---|---|---|
| 无 DoR | 中期发现需求不清晰 | 用 DoR 控制冲刺入口 |
| 软 DoD | “完成”意味不同事物 | 书面 DoD 检查清单 |
| 大故事 | 从未完成，难以跟踪 | 切片到 <8 点 |
| 缺失 AC | 构建错误内容 | Gherkin 格式 AC |
| 无所有权 | 工作遗漏 | 每个史诗的 RACI |
| 基于希望的估计 | 总是延迟 | 使用参考尺度 + 缓冲 |
可选：AI/自动化
注意：AI 可以协助，但不应取代人类在优先级和验收上的判断。
- 生成验收标准 - 从故事描述草拟（需要审查）
- 建议故事切片 - 基于复杂性分析
- 依赖映射 - 识别阻塞关系
- AI 增强规划 - 使用 LLM 草拟计划，但验证假设
AI 辅助规划最佳实践
- 规划先行 - 编码前创建计划
- 范围管理 - 保持任务小且可验证
- 迭代步骤 - 通过检查点增量交付
- 人工监督 - 验证假设和输出（测试、日志、指标）
有限声明
- AI 生成的验收标准需要人工审查
- 故事点估计需要团队校准
- 依赖映射建议需要验证
- AI 对交付稳定性的影响需要监控
导航
资源
- references/planning-templates.md - 常见场景的计划模板
- references/session-patterns.md - 多会话项目管理
- references/flow-metrics.md - DORA 指标、WIP 限制、流程优化
- assets/template-dor-dod.md - DoR/DoD 检查清单、估计、跨职能协调
- assets/template-work-item-ticket.md - 工单模板（DoR/DoD + 验收标准）
- data/sources.json - 工作流程方法论参考
相关技能
- …/software-architecture-design/SKILL.md - 系统设计规划
- …/docs-ai-prd/SKILL.md - 需求到计划转换
- …/qa-testing-strategy/SKILL.md - TDD 工作流程集成
- …/qa-debugging/SKILL.md - 系统化调试计划