chore: import upstream snapshot with attribution

2026-07-13 12:38:58 +08:00
commit bb5c75ce05
8824 changed files with 1946442 additions and 0 deletions
@@ -0,0 +1,134 @@
+# 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. **中断恢复**: 重新读取文件即可继续