任务格式规范

# 任务格式规范 ## 基本结构 markdown ## Implementation Tasks - [ ] **任务标题** `priority:N` `phase:PHASE` `deps:Dep1,Dep2` - files: file1.py, file2.py - [ ] 验收标准 1 - [ ] 验收标准 2 ## 任务行 - [ ] **任务标题** `priority:1` `phase:model` `deps:其他任务` | 组件 | 必需 | 描述 | |-----------|----------|-------------| | `- [ ]` | 是 | 复选框（未选中） | | `**Title**` | 是 | 加粗的任务标题 | | `priority:N` | 否 | 优先级 1-10（默认：5，数字越小优先级越高） | | `phase:X` | 否 | 阶段：model, api, ui, test, docs | | `deps:A,B` | 否 | 逗号分隔的依赖任务标题 | ## 任务详情（缩进） ### 文件行 markdown - files: src/models/user.py, tests/test_user.py 创建/修改的文件列表，以逗号分隔。 ### 验收标准 markdown - [ ] 用户模型包含 email 字段 - [ ] 密码哈希使用 bcrypt 每个验收标准的复选框。必须全部勾选任务才算完成。 ### 失败原因（自动添加） markdown - reason: 数据库连接失败 当任务被标记为失败时自动添加。 ## 状态标记 | 状态 | 复选框 | 标记 | |--------|----------|--------| | 待处理 | `- [ ]` | (无) | | 已完成 | `- [x]` | ✅ | | 失败 | `- [x]` | ❌ | ## 优先级顺序 1. 优先级数字越小 = 优先执行 2. 必须先完成依赖项 3. 依赖项未满足的任务处于“阻塞”状态 ## 示例 ### 待处理任务 markdown - [ ] **创建用户模型** `priority:1` `phase:model` - files: src/models/user.py - [ ] 用户模型包含 email 和 password_hash 字段 - [ ] 已实现邮箱验证 ### 已完成任务 markdown - [x] **创建用户模型** `priority:1` `phase:model` ✅ - files: src/models/user.py - [x] 用户模型包含 email 和 password_hash 字段 - [x] 已实现邮箱验证 ### 失败任务 markdown - [x] **创建用户模型** `priority:1` `phase:model` ❌ - files: src/models/user.py - [ ] 用户模型包含 email 和 password_hash 字段 - reason: 未安装 bcrypt 包 ### 带有依赖的任务 markdown - [ ] **创建认证 API** `priority:3` `phase:api` `deps:创建用户模型,实现 JWT` - files: src/api/auth.py - [ ] POST /register 接口 - [ ] POST /login 接口 在“创建用户模型”和“实现 JWT”均完成之前，此任务不会被 `next` 指令选中。