# Workflow Guide

从需求分析到自动化实现的完整流程。

## 流程概览

```
┌─────────────────────────────────────────────────────┐
│  /feature-analyzer 实现用户登录功能                   │
│  → 对话设计 → 生成 docs/designs/xxx.md               │
│  → "设计已完成，要开始实现吗？"                        │
└─────────────────────────────────────────────────────┘
                         ↓
              用户: "开始实现" / "Yes"
                         ↓
┌─────────────────────────────────────────────────────┐
│  /feature-pipeline docs/designs/xxx.md              │
│  → 读取任务列表 → 循环执行 → 更新 checkbox           │
└─────────────────────────────────────────────────────┘
                         ↓
┌─────────────────────────────────────────────────────┐
│  完成！"要提交到 Git 吗？"                           │
└─────────────────────────────────────────────────────┘
```

## 使用示例

### 完整流程

```
用户: /feature-analyzer 实现用户登录功能

Claude: [逐步对话理解需求...]
        [设计方案...]

        设计已保存到 docs/designs/2026-01-02-user-auth.md

        任务列表：
        1. Create User model (priority: 1)
        2. Implement JWT utils (priority: 2)
        3. Create auth API (priority: 3)

        设计已完成，要开始实现吗？

用户: 开始实现

Claude: 开始执行任务...

        ---TASK RESULT---
        task: Create User model
        status: completed
        files: [src/models/user.py]
        ---END TASK RESULT---

        ---TASK RESULT---
        task: Implement JWT utils
        status: completed
        files: [src/utils/jwt.py]
        ---END TASK RESULT---

        [继续执行...]

        所有任务完成！
        ✅ 3/3 tasks completed

        要提交到 Git 吗？
```

### 直接执行已有设计

```
用户: /feature-pipeline docs/designs/2026-01-02-user-auth.md

Claude: [读取文件，开始执行任务...]
```

### 恢复中断的工作

```
用户: /feature-pipeline docs/designs/2026-01-02-user-auth.md

Claude: 正在恢复...
        已完成: 2/5 任务
        从 "Create auth API" 继续...

        [继续执行剩余任务...]
```

## 设计文档格式

设计文档中的任务列表使用 markdown checkbox：

```markdown
# User Auth Design

## Overview
...

## Implementation Tasks

- [ ] **Create User model** `priority:1` `phase:model`
  - files: src/models/user.py
  - [ ] User model has email field
  - [ ] Password hashing implemented

- [ ] **Implement JWT utils** `priority:2` `phase:model`
  - files: src/utils/jwt.py
  - [ ] generate_token() works
  - [ ] verify_token() works

- [ ] **Create auth API** `priority:3` `phase:api` `deps:Create User model,Implement JWT utils`
  - files: src/api/auth.py
  - [ ] POST /login endpoint
  - [ ] POST /register endpoint
```

执行后：

```markdown
- [x] **Create User model** `priority:1` `phase:model` ✅
  - files: src/models/user.py
  - [x] User model has email field
  - [x] Password hashing implemented

- [x] **Implement JWT utils** `priority:2` `phase:model` ✅
  ...
```

## 优势

1. **可读性**: 设计文档直接可读
2. **Git 友好**: markdown diff 清晰
3. **简单**: 无需额外的 session 文件
4. **中断恢复**: 重新读取文件即可继续