# dev-workflow-skill

**Repository Path**: andy-alone/dev-workflow-skill

## Basic Information

- **Project Name**: dev-workflow-skill
- **Description**: 开发工作流程skill
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-05-27
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: skill相关

## README

# Workflow Skill Collection

一个面向通用项目开发流程的 Claude Code skill 集合。

这个项目将一个完整的软件开发过程拆分为多个可控阶段，并通过 `workflow-controller` 统一编排，适合按阶段推进、逐步确认、保留产物与状态的开发方式。

## 项目目标

该项目用于把“从需求到开发到测试修复”的流程沉淀为一组可复用的 skill，帮助在 Claude Code 中以更结构化的方式推进项目。

核心特点：

- 按阶段推进开发流程
- 每个阶段都有明确产物
- 每个阶段结束后都要求用户确认
- 未确认时不允许进入下一阶段
- 支持流程恢复、进度查看、阶段重做与跳步控制
- 对系统设计阶段做了更细的子步骤拆分

## 流程总览

主流程如下：

1. 初始化项目
2. 需求收集与整理
3. 原型设计
4. 系统设计
5. 系统开发
6. 自动化测试
7. bug 修复

对应 skill 流程：

```text
workflow-controller
  -> workflow-entry
  -> workflow-init
  -> workflow-requirements
  -> workflow-prototype
  -> workflow-system-design
  -> workflow-development
  -> workflow-testing
  -> workflow-bugfix
```

### 核心规则

- 每个阶段都必须产出结果
- 每个阶段都必须请求用户确认
- 用户未确认前，不得进入下一阶段
- 用户提出修改意见时，停留在当前阶段继续迭代
- 测试发现 bug 后，进入 bug 修复阶段
- bug 未修复完成前，不得宣称流程完成

## 目录结构

```text
.
├─ workflow-controller/
├─ workflow-entry/
├─ workflow-init/
├─ workflow-requirements/
├─ workflow-prototype/
├─ workflow-system-design/
├─ workflow-development/
├─ workflow-testing/
├─ workflow-bugfix/
└─ workflow-shared/
```

### 主要目录说明

#### `workflow-controller/`

默认入口与总控 skill。

负责：

- 启动流程
- 继续流程
- 恢复流程
- 查看当前进度
- 控制阶段推进
- 管理状态文件
- 阻止非法跳转

#### `workflow-entry/`

流程入口阶段。用于检查输入是否足够启动整个工作流，并向用户说明完整阶段与推进规则。

#### `workflow-init/`

初始化阶段。用于建立流程文档结构和后续阶段产物基础。

#### `workflow-requirements/`

需求收集与整理阶段。用于从原始需求中梳理目标、功能点、边界与待确认事项。

#### `workflow-prototype/`

原型设计阶段。默认产出可本地打开的 HTML 静态原型。

#### `workflow-system-design/`

系统设计阶段。是本项目中拆分最细的阶段，包含多个固定子步骤。

#### `workflow-development/`

系统开发阶段。根据已确认的需求、原型和系统设计实现代码，并记录验证结果。

#### `workflow-testing/`

自动化测试阶段。执行测试并产出测试结果与 bug 清单。

#### `workflow-bugfix/`

bug 修复阶段。根据测试问题完成修复并执行回归验证。

#### `workflow-shared/`

共享参考文档目录，存放多个阶段共用的说明与模板。

## 系统设计阶段子步骤

`workflow-system-design` 包含以下子步骤：

```text
design_scope
  -> technology_selection
  -> module_design
  -> entity_er_design
  -> database_ddl
  -> api_design
  -> system_design_summary
```

说明：

- 每个子步骤都应生成独立文档
- 每个子步骤都应有确认过程
- 所有子步骤完成并确认后，才能进入开发阶段

## 状态管理

该项目通过状态文件记录当前流程位置与各阶段状态。

默认状态文件路径：

```text
docs/workflow/workflow-state.json
```

状态文件通常用于：

- 记录当前阶段
- 记录阶段状态（未开始、进行中、待确认、已确认、阻塞）
- 保存各阶段产物路径
- 支持中断后恢复流程
- 支持查看当前进度

## 如何使用

### 快速开始

下面是一个最小使用示例，演示如何从 0 开始推进一个项目流程。

#### 示例场景

你已经有一份需求，想让 Claude Code 按阶段带你完成整个开发流程。

你可以直接这样说：

```text
开始项目开发流程，我会提供需求文档。
```

或者：

```text
按这个需求启动流程，先从初始化开始。
```

如果流程已经做过一半，也可以这样说：

```text
继续上次流程
```

#### 一个典型交互过程

1. 你发起流程请求，进入 `workflow-controller`
2. `workflow-controller` 判断当前是否已有状态文件
3. 如果是首次开始，则进入 `workflow-entry`
4. `workflow-entry` 检查需求是否足够、说明完整流程阶段
5. 条件满足后，进入初始化阶段
6. 每完成一个阶段，Claude 都会产出结果并向你请求确认
7. 你确认后，流程才会继续进入下一阶段

#### 你会看到的典型阶段推进

```text
开始项目开发流程
  -> workflow-controller
  -> workflow-entry
  -> workflow-init
  -> workflow-requirements
  -> workflow-prototype
  -> workflow-system-design
  -> workflow-development
  -> workflow-testing
  -> workflow-bugfix（如测试发现问题）
```

#### 使用建议

- 如果你不确定从哪里开始，直接从 `workflow-controller` 开始
- 如果你已经完成前置阶段，也可以指定进入某个阶段
- 如果中途中断，优先使用“继续上次流程”或“恢复流程”
- 如果某阶段结果不满意，直接要求在当前阶段继续迭代

### 方式一：从总控入口开始

这是推荐方式。

当你希望开始或恢复整个流程时，从 `workflow-controller` 进入。

适合的表达包括：

- 开始项目开发流程
- 按需求文档启动流程
- 继续上次流程
- 恢复流程
- 查看当前进度
- 从某阶段继续

`workflow-controller` 会根据当前状态决定应该进入哪个阶段，并阻止不符合规则的推进。

### 方式二：直接进入某个阶段

当你已经明确知道自己要执行哪个阶段时，也可以直接调用单独阶段 skill，例如：

- `workflow-entry`
- `workflow-requirements`
- `workflow-system-design`
- `workflow-development`

但前提是上游输入与确认状态已经满足要求。

## 适用场景

这个项目适合：

- 需要严格阶段确认的项目开发流程
- 希望沉淀需求、原型、设计、开发、测试全过程产物
- 需要支持中断恢复的长流程任务
- 希望减少“跳步骤直接编码”带来的返工风险
- 适合将 Claude Code 作为流程编排器使用的场景

## 参考文件

项目中已有的重要参考文档包括：

- `workflow-shared/references/workflow-overview.md`
- `workflow-shared/references/workflow-system-overview.md`
- `workflow-controller/references/workflow-state.template.json`
- `workflow-controller/references/transition-rules.md`
- `workflow-controller/references/recovery-rules.md`

以及系统设计阶段相关模板：

- `workflow-system-design/references/module-design-template.md`
- `workflow-system-design/references/database-design-template.md`
- `workflow-system-design/references/api-design-template.md`
- `workflow-system-design/references/technology-selection-template.md`
- `workflow-system-design/references/entity-er-template.md`

## 使用建议

- 默认优先使用 `workflow-controller` 作为入口
- 不要在用户未确认时强行进入下一阶段
- 修改阶段顺序或系统设计子步骤时，要同步更新相关说明与模板
- 若状态文件与实际产物不一致，应先处理冲突，再继续流程

## 当前项目现状

从当前仓库结构看，这个项目已经包含：

- 主流程 skill 定义
- 系统设计阶段拆分结构
- 共享 reference 文档
- 若干模板文档

目前更像是一个“流程型 skill 仓库”，而不是传统的应用程序仓库。

---

如果你准备继续完善这个仓库，下一步通常可以考虑：

- 补充每个 skill 的使用示例
- 增加状态文件模板说明
- 增加一个最小端到端示例流程
- 统一各阶段产物的目录约定