---
id: xstongxue/best-skills/dev-workflow
version: "577cd989"
license: Apache-2.0
install: manual
updated: 2026-07-19
---

# dev-workflow — Dev-workflow structures your development process across five stages—requirements understanding, design, implementation, code review, and bug fixing. It automatically detects which stage you're in via keywords and guides you through the appropriate steps, saving outputs to your docs folder.

Publisher: xstongxue · Stars: 2407 · Updated: 2026-07-19

Install (manual): `git clone https://github.com/xstongxue/best-skills`

## SKILL.md

# 开发流程五步法

需求理解 → 方案设计 → 代码实现 → 代码审查 → Bug 修复

## 使用时机

- 用户描述新功能/项目想法，需要需求分析
- 用户提到「方案设计」「架构设计」「怎么实现」
- 用户提到「代码实现」「开始写代码」「帮我实现」
- 用户提到「代码审查」「Review」「检查代码」「看看有没有问题」
- 用户提到「bug」「报错」「崩溃」「异常」「不工作」「出错了」「测试失败」

## Step 1：识别当前步骤

根据用户需求选择对应 reference 文件执行：


| 步骤     | 文件                                               | 触发关键词                     |
| ------ | ------------------------------------------------ | ------------------------- |
| 需求理解   | [requirement.md](reference/requirement.md)       | 需求分析、理解需求、整理需求、帮我梳理       |
| 方案设计   | [design.md](reference/design.md)                 | 方案设计、技术设计、架构设计、怎么实现       |
| 代码实现   | [implementation.md](reference/implementation.md) | 代码实现、开始写代码、帮我实现、写一下       |
| 代码审查   | [review.md](reference/review.md)                 | 代码审查、Review、检查代码、看看有没有问题  |
| Bug 修复 | [bug-fix.md](reference/bug-fix.md)               | bug、报错、崩溃、异常、不工作、出错了、测试失败 |


## Step 2：收集输入

- **需求理解**：从用户描述或对话中提取功能想法、约束条件
- **方案设计**：确认已有需求文档，或简要收集关键信息
- **代码实现**：确认已有技术方案，或根据需求快速拟定实现思路
- **代码审查**：明确审查范围（哪些文件/模块）
- **Bug 修复**：确认错误信息、复现步骤、环境信息

## Step 3：执行、输出与自动落盘

读取对应 reference 中的完整流程，按步骤执行，输出符合该阶段要求的交付物。

其中以下步骤必须自动写入文档：

- **需求理解**：
  - 单模块/未指定模块：将最终需求文档**追加写入**当前工作目录的 `docs/需求理解.md`
  - 多模块且已识别模块名：将最终需求文档**追加写入** `docs/<module>/需求理解.md`
- **方案设计**：
  - 单模块/未指定模块：将最终方案文档**追加写入**当前工作目录的 `docs/方案设计.md`
  - 多模块且已识别模块名：将最终方案文档**追加写入** `docs/<module>/方案设计.md`
- **代码审查**：
  - 单模块/未指定模块：将最终审查报告**追加写入**当前工作目录的 `docs/代码审查.md`
  - 多模块且已识别模块名：将最终审查报告**追加写入** `docs/<module>/代码审查.md`

落盘规则：

- 默认目录为当前工作目录 `docs/`，若不存在则创建后再写入
- 多模块项目优先使用 `docs/<module>/` 分目录；若无法确定模块则回退到 `docs/` 根目录
- `<module>` 使用稳定标识（建议用目录名/包名，避免同义词）
- 文件不存在则创建，存在则追加，不覆盖历史内容
- 每次新增内容前写入时间标题：`## YYYY-MM-DD HH:mm`
- 标题后粘贴本次完整输出正文，末尾加分隔线 `---`
- 若用户明确指定了其他文件路径，优先按用户指定路径写入
- 可选维护 `docs/模块索引.md` 记录模块名与文档路径映射，便于检索与归档

## 注意事项

- 流程串联：需求理解 → 方案设计 → 代码实现 → 代码审查 → Bug 修复；每步完成后提示用户进入下一阶段


- 上游缺失时：提示用户先完成前置步骤，或简要收集关键信息后继续
- 需求理解、方案设计与代码审查阶段默认必须自动落盘（追加写入），不要覆盖历史记录

[View on SkillFed](https://skillfed.io/xstongxue/best-skills/dev-workflow) · [View on GitHub](https://github.com/xstongxue/best-skills)