Dev Workflow Guide

---
source: ../../../../skills/dev-workflow-guide/SKILL.md
source_version: 1.0.0
translation_version: 1.1.0
last_synced: 2026-08-17
source_hash: f90f1fe1f6f2
status: current
description: |
  [UDS] 把目前的软件开发阶段对应到正确的 UDS 命令与 Skill。
  Use when: 不确定手上的任务该用哪个 UDS 命令、初次上手 UDS、带着一个功能从规划走到发布。
  Not for: 选择或切换方法论——请用 /methodology；实际执行某阶段的工作——请用该阶段自己的 Skill。
  Keywords: workflow, development phase, command routing, which command, UDS guide, 开发阶段, 命令对照, 流程指南.
---

# 开发工作流程指南

> **语言**: [English](../../../../skills/dev-workflow-guide/SKILL.md) | 简体中文

将你目前的软件开发阶段对应到正确的 UDS 命令与技能。即时了解在开发的每个阶段应该使用哪些工具。

> **相关**：如需选择或切换开发方法论（SDD、BDD、TDD），请改用 `/methodology`。

## 软件开发阶段总览

```
I. Planning ──► II. Testing Design ──► III. Implementation ──► IV. Quality Gates
   需求设计          测试驱动开发            代码开发              品质保证

V. Release ──► VI. Documentation ──► VII. Standards ──► VIII. Advanced
   版本提交         文档与架构              工具与标准           进阶分析
```

### 快速对照表

| 阶段 | UDS 命令 | 用途 |
|------|---------|------|
| **I. 规划与设计** | `/brainstorm` `/requirement` `/sdd` `/reverse` `/api-design` `/database` | 需求、规格、API/DB 设计 |
| **II. 测试驱动开发** | `/bdd` `/atdd` `/tdd` `/coverage` `/derive` `/ac-coverage` | 先写测试再写代码 |
| **III. 实现** | `/refactor` `/reverse` `/migrate` `/durable` | 撰写、改善与迁移代码 |
| **IV. 品质关卡** | `/checkin` `/code-review` `/security` `/scan` `/incident` | 品质、安全、事故响应 |
| **V. 发布与提交** | `/commit` `/changelog` `/release` `/pr` `/ci-cd` | 版本、提交、PR、CI/CD |
| **VI. 文档** | `/docs` `/docgen` | 文档与项目结构 |
| **VII. 工具与标准** | `/discover` `/guide` `/metrics` `/audit` | 参考指南、指标、审计 |
| **VIII. 进阶分析** | `/methodology` | 跨方法论工作流程 |

## 常见场景

### 场景 1：新功能开发

从零开始构建新功能的推荐流程：

```
/brainstorm → /requirement → /sdd → /derive → /tdd → /checkin → /commit
```

| 步骤 | 命令 | 做什么 |
|------|------|--------|
| 1 | `/brainstorm` | 探索想法与方法 |
| 2 | `/requirement` | 撰写用户故事（INVEST 准则） |
| 3 | `/sdd` | 创建规格文件 |
| 4 | `/derive` | 从规格产生测试骨架 |
| 5 | `/tdd` | 用红绿重构循环实现 |
| 6 | `/checkin` | 验证品质关卡 |
| 7 | `/commit` | 创建规范化提交 |

### 场景 2：修复错误

修复既有代码错误的推荐流程：

```
/discover → /reverse → /tdd → /checkin → /commit
```

| 步骤 | 命令 | 做什么 |
|------|------|--------|
| 1 | `/discover` | 评估受影响区域健康度 |
| 2 | `/reverse` | 理解现有代码结构 |
| 3 | `/tdd` | 先写失败测试，再修复 |
| 4 | `/checkin` | 验证品质关卡 |
| 5 | `/commit` | 创建规范化提交 |

### 场景 3：重构

代码重构的推荐流程：

```
/discover → /reverse → /coverage → /refactor → /checkin → /commit
```

| 步骤 | 命令 | 做什么 |
|------|------|--------|
| 1 | `/discover` | 评估项目健康度与风险 |
| 2 | `/reverse` | 记录目前行为 |
| 3 | `/coverage` | 确保测试安全网存在 |
| 4 | `/refactor` | 套用重构策略 |
| 5 | `/checkin` | 验证品质关卡 |
| 6 | `/commit` | 创建规范化提交 |

### 场景 4：安全审查

安全审查与漏洞修复的推荐流程：

```
/scan → /security → /checkin → /commit
```

| 步骤 | 命令 | 做什么 |
|------|------|--------|
| 1 | `/scan` | 执行自动化安全扫描（依赖项、密钥） |
| 2 | `/security` | 深入安全审查（OWASP） |
| 3 | `/checkin` | 验证品质关卡 |
| 4 | `/commit` | 创建规范化提交 |

### 场景 5：API 设计与实现

设计与实现 API 的推荐流程：

```
/brainstorm → /api-design → /sdd → /derive → /tdd → /pr
```

| 步骤 | 命令 | 做什么 |
|------|------|--------|
| 1 | `/brainstorm` | 探索 API 方案 |
| 2 | `/api-design` | 设计端点与 schema |
| 3 | `/sdd` | 创建规格文件 |
| 4 | `/derive` | 产生测试骨架 |
| 5 | `/tdd` | 搭配测试实现 |
| 6 | `/pr` | 创建 Pull Request |

## 使用方式

```bash
/dev-workflow                    # 显示完整阶段总览
/dev-workflow planning           # 获取第一阶段指引
/dev-workflow testing            # 获取第二阶段指引
/dev-workflow new-feature        # 获取新功能工作流程
/dev-workflow bug-fix            # 获取修复错误工作流程
/dev-workflow refactoring        # 获取重构工作流程
```

### 支持的参数

| 参数 | 说明 |
|------|------|
| `planning` | 第一阶段：规划与设计 |
| `testing` | 第二阶段：测试驱动开发 |
| `implementation` | 第三阶段：实现 |
| `quality` | 第四阶段：品质关卡 |
| `release` | 第五阶段：发布与提交 |
| `docs` | 第六阶段：文档 |
| `standards` | 第七阶段：工具与标准 |
| `advanced` | 第八阶段：进阶系统分析 |
| `new-feature` | 场景：新功能开发 |
| `bug-fix` | 场景：修复错误 |
| `refactoring` | 场景：重构 |
| `security` | 场景：安全审查 |
| `api` | 场景：API 设计 |

## 工作流程行为

调用时：

1. **无参数**：显示完整的阶段总览表，询问用户目前在哪个阶段
2. **阶段参数**：显示该阶段的详细指引，包含所有相关命令与示例
3. **场景参数**：显示该场景的推荐逐步工作流程

此技能会从 [workflow-phases.md](../../../../skills/dev-workflow-guide/workflow-phases.md) 读取详细的阶段信息。

## 下一步引导

`/dev-workflow` 完成后，AI 助手应根据用户情况建议：

> **工作流程已显示。建议下一步：**
> - 新功能开发 → 执行 `/brainstorm` 探索想法 ⭐ **推荐**
> - 修复错误 → 执行 `/discover` 评估受影响区域
> - 重构代码 → 执行 `/discover` 评估健康度
> - 遗留系统 → 执行 `/reverse` 进行系统考古
> - 安全审查 → 执行 `/scan` 扫描漏洞
> - API 开发 → 执行 `/api-design` 设计端点
> - 事故响应 → 执行 `/incident` 启动响应流程

## 参考

- [详细阶段指南](../../../../skills/dev-workflow-guide/workflow-phases.md) - 完整的逐阶段参考
- [日常工作流程指南](../../../../adoption/DAILY-WORKFLOW-GUIDE.md) - 综合日常工作流程指南
- [功能开发工作流程](../../../../skills/workflows/feature-dev.workflow.yaml) - 自动化功能开发工作流程
- [集成流程工作流程](../../../../skills/workflows/integrated-flow.workflow.yaml) - 完整的 ATDD/SDD/BDD/TDD 工作流程

---

## 版本历史

| 版本 | 日期 | 变更 |
|------|------|------|
| 1.1.0 | 2026-03-24 | 新增 11 个命令、2 个新场景（安全审查、API 设计） |
| 1.0.0 | 2026-03-04 | 初始版本：8 个开发阶段、3 个场景、基于阶段的导航 |

---

## 许可证

本技能依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。

**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)