# doc-driven-workflow

> 文档驱动开发工作流 skill，确保 AI 严格遵循完整的开发流程：前置记录变更、任务追踪、系统性规划。

- Author: luoxia
- Repository: luoluoluoxiaxia/ai-skills
- Version: 20251220162858
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/luoluoluoxiaxia/ai-skills
- Web: https://mule.run/skillshub/@@luoluoluoxiaxia/ai-skills~doc-driven-workflow:20251220162858

---

# doc-driven-workflow Skill

文档驱动开发工作流 skill，确保 AI 严格遵循完整的开发流程：前置记录变更、任务追踪、系统性规划。

## 📋 Skill 概述

- **版本**: 1.0.0
- **作者**: luoxia
- **核心原则**: 所有代码改动都必须创建任务文件、前置记录变更历史、系统性规划

## 🎯 核心功能

1. **完整的 7 阶段工作流程**（阶段 0-6）
2. **前置记录变更历史机制** - 修改代码前先记录文档
3. **三层任务追踪** - 任务文件 + implementation.md checkbox + TodoWrite
4. **19 个文档模板** - 核心 15 + 可选 4
5. **自动化项目初始化** - scripts/init-project.sh 脚本

## 📚 参考文件

根据不同使用场景，参考以下文件：

### 初始化相关
- **[reference/initialization.md](reference/initialization.md)** - 项目初始化、模板使用、快速开始

### 任务和脑暴状态查询
- **[reference/status-query.md](reference/status-query.md)** - 查询任务状态、脑暴进度、文档索引

### 工作流程执行
- **[reference/workflow.md](reference/workflow.md)** - 完整的 7 阶段工作流指引、核心原则、检查清单

### 新手入门
- **[reference/onboarding.md](reference/onboarding.md)** - 15 分钟快速入门指南（简化版工作流）

## 🚀 快速使用

### 当用户询问初始化
```bash
# 阅读初始化文档
cat reference/initialization.md

# 如需运行初始化脚本
bash scripts/init-project.sh
```

### 当用户询问任务状态
```bash
# 阅读状态查询文档
cat reference/status-query.md
```

### 当执行代码改动任务
```bash
# 阅读完整工作流文档
cat reference/workflow.md
```

### 当新用户需要入门
```bash
# 阅读新手指南
cat reference/onboarding.md
```

## 🔍 使用场景判断

根据用户请求，选择性加载对应文件：

| 用户请求类型 | 加载文件 |
|------------|---------|
| "初始化项目文档结构" | initialization.md |
| "运行 init-project.sh" | initialization.md |
| "查看当前任务" | status-query.md |
| "有哪些脑暴" | status-query.md |
| "文档索引是什么" | status-query.md |
| 任何代码改动需求 | workflow.md |
| "如何使用这个 skill" | onboarding.md |
| "快速入门" | onboarding.md |

## ⚠️ 重要提醒

1. **只加载需要的文件** - 不要一次性读取所有 reference 文件
2. **渐进式披露** - 按需加载，节省 token
3. **工作流是核心** - workflow.md 是执行任务时的主要参考
4. **新手先看 onboarding** - 简化版更容易理解

## 📦 模板文件

所有模板文件位于 `templates/` 目录：
- 核心模板 15 个（API、数据库、任务、脑暴等）
- 可选模板 4 个（架构、需求、会话记录等）

详见 [templates/README.md](templates/README.md)

## 🔗 相关文档

- [README.md](README.md) - 完整的 skill 说明文档
- [USAGE.md](USAGE.md) - 使用说明
- [templates/README.md](templates/README.md) - 模板文档总览