davila7--claude-code-templates/cli-tool/components/skills/development/task-execution-engine/references/workflow-guide.md

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：

# 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

执行后：

- [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. 中断恢复: 重新读取文件即可继续