结构化开发工作流方法论

技能文档

---
name: superpowers-skill
title: 结构化开发工作流方法论
description: 完整的软件开发方法论与工作流编排系统，提供结构化、可重复的七阶段流程：需求头脑风暴、设计验证、实现计划、测试驱动开发（TDD）、子任务驱动开发、代码审查、分支收尾。当用户进行编码、搭建项目、重构、修 bug 或任何编程任务时触发。触发词：开发工作流、TDD、代码审查、头脑风暴、实现计划、重构、编程任务、软件开发流程。
category: 开发工具
---

# 结构化开发工作流方法论

## 概述

本技能提供一套结构化、可重复的软件开发工作流，将开发过程拆分为 7 个核心阶段，每个阶段都有明确的产出与检查点，确保输出高质量、可维护的代码。

## 技能工作流

共 7 个阶段，按顺序执行，每个阶段不可跳过。

### 步骤1：需求头脑风暴

- **触发**：任何开发任务开始时自动激活
- **目标**：通过提问澄清用户真实需求，探索替代方案，产出可验证的设计文档
- **关键动作**：
  - 追问用户真正想实现什么（而非仅表面需求）
  - 探索多种设计方案与权衡
  - 设计文档分块呈现（每块不超过 200 字）
  - 生成设计文档并保存到 `design.md`
  - 获得用户对设计的确认

### 步骤2：设计验证

- **触发**：头脑风暴完成后
- **目标**：确保设计完整、可行、符合用户预期
- **关键动作**：
  - 分块展示设计供用户审查
  - 逐块确认「这部分是否清晰？」
  - 确认技术可行性与约束条件
  - 记录反馈并更新设计

### 步骤3：实现计划

- **触发**：设计验证通过后
- **目标**：将设计分解为可执行的细粒度开发任务
- **关键动作**：
  - 创建详细任务清单，每个任务 2-5 分钟可完成
  - 每个任务包含：精确文件路径、完整代码、验证步骤
  - 遵循 YAGNI（不做用不上的）与 DRY（不重复自己）
  - 生成计划文档并保存到 `plan.md`

### 步骤4：测试驱动开发（TDD）

- **触发**：进入实现阶段时自动激活
- **目标**：强制执行红-绿-重构循环
- **关键动作**：
  - 先写一个失败的测试（红）
  - 写最少代码让测试通过（绿）
  - 重构保持代码整洁
  - 删除任何在测试之前写的代码
  - 每个功能都遵循此循环

### 步骤5：子任务驱动开发

- **触发**：计划批准后
- **目标**：用子任务方式并行或串行执行开发任务
- **关键动作**：
  - 每个任务派发独立的子任务执行
  - 两阶段审查：先规范符合性，后代码质量
  - 批量执行时设置人工检查点
  - 子任务偏离计划时立即停止并上报

### 步骤6：代码审查

- **触发**：任务之间或任务完成时
- **目标**：确保代码符合计划与质量标准
- **关键动作**：
  - 对照计划审查代码
  - 按严重度上报问题：关键（阻塞）、主要、次要
  - 关键问题必须修复后才能继续
  - 生成审查报告并保存到 `review.md`

### 步骤7：分支收尾

- **触发**：所有任务完成后
- **目标**：干净地结束开发周期
- **关键动作**：
  - 验证所有测试通过
  - 提供选项：合并、创建 PR、保留分支、丢弃
  - 清理工作区
  - 生成最终报告

## 核心原则

1. **测试驱动**：永远先写测试；红-绿-重构循环；测试即文档与设计工具
2. **系统化而非随意**：遵循流程而非猜测；每个决策有依据；记录所有假设与决策
3. **降低复杂度**：简单是首要目标；删除不必要的代码；优先最简单的可行方案
4. **证据优于声明**：验证而非宣称成功；用测试证明功能；用数据支撑决策

## 触发机制

本工作流是强制性流程，检测到以下情形时对应阶段必须激活：

1. 用户提到开发/编程 → 开始头脑风暴
2. 设计完成 → 开始实现计划
3. 开始写代码 → 进入 TDD
4. 任务需要并行 → 启动子任务驱动开发
5. 代码完成 → 开始代码审查
6. 项目完成 → 进入分支收尾

## 交付物

每个阶段产出对应文档，确保可追溯：

| 阶段 | 输出文件 | 用途 |
|------|----------|------|
| 头脑风暴 | `design.md` | 完整设计文档 |
| 计划 | `plan.md` | 详细实现计划 |
| 开发 | `code/` | 源代码 |
| 审查 | `review.md` | 代码审查报告 |
| 收尾 | `final_report.md` | 项目总结 |

## 示例流程

**用户需求**：「帮我做一个待办事项应用」

1. **头脑风暴**：询问需求（Web 还是移动端？需要登录吗？数据怎么存？）
2. **设计**：生成界面设计、架构图、API 设计
3. **计划**：拆解为：创建项目结构、实现登录、构建增删改查、开发前端
4. **TDD**：每个功能先写测试
5. **子任务**：并行派发不同模块的开发
6. **审查**：审查各模块代码质量
7. **收尾**：合并代码，生成部署文档

## 常见问题

- **子任务偏离计划**：立即停止，分析偏差原因，调整计划或重新派发
- **测试失败**：回到红灯阶段，分析失败原因，修复测试或代码
- **需求变更**：回到头脑风暴阶段，重新评估设计

## 参考资料

- 工作流详细指南 → [references/workflow.md](references/workflow.md)
- 开发最佳实践 → [references/best_practices.md](references/best_practices.md)

使用说明

# 结构化开发工作流方法论

一套七阶段软件开发工作流：需求头脑风暴 → 设计验证 → 实现计划 → 测试驱动开发（TDD）→ 子任务驱动开发 → 代码审查 → 分支收尾。

## 功能

- 强制性阶段化流程，每阶段有明确产出（design.md / plan.md / review.md / final_report.md）
- 内置 TDD 红-绿-重构循环与两阶段代码审查
- 支持子任务并行开发与人工检查点
- 附带工作流详细指南与最佳实践参考文档

## 最简用法

对任何开发任务说「按照结构化开发工作流来做……」即可激活，例如：

```text
按照结构化开发工作流，帮我开发一个用户登录模块
```

技能会自动从需求头脑风暴开始，逐阶段推进直到生成最终报告。

## 适用场景

编码、搭建项目、重构、修 bug 等任何编程任务，尤其是需要完整流程管控的多阶段开发。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。