tasks

name	tasks
description	根据可用的设计产物为功能生成可操作、按依赖排序的任务列表。
disable-model-invocation	true
allowed-tools	["Bash(node */check-prerequisites.mjs*)"]

用户输入

$ARGUMENTS

你必须在继续之前考虑用户输入（如果不为空）。

大纲

1. 设置：从仓库根目录运行 node ${WAVE_PLUGIN_ROOT}/scripts/check-prerequisites.mjs --json 并解析 FEATURE_DIR 和 AVAILABLE_DOCS 列表。所有路径必须是绝对路径。对于参数中的单引号如 "I'm Groot"，使用转义语法：例如 'I'''m Groot'（或尽可能使用双引号："I'm Groot"）。

2. 加载设计文档：从 FEATURE_DIR 读取：

   • 必需：plan.md（技术栈、库、结构）、spec.md（带优先级的用户故事）
   • 可选：data-model.md（实体）、contracts/（API 端点）、research.md（决策）、quickstart.md（测试场景）
   • 注意：并非所有项目都有所有文档。根据现有内容生成任务。

3. 执行任务生成工作流：

   • 加载 plan.md 并提取技术栈、库、项目结构
   • 加载 spec.md 并提取用户故事及其优先级（P1、P2、P3 等）
   • 如果 data-model.md 存在：提取实体并映射到用户故事
   • 如果 contracts/ 存在：将端点映射到用户故事
   • 如果 research.md 存在：提取决策用于设置任务
   • 按用户故事组织生成任务（见下文任务生成规则）
   • 生成依赖图显示用户故事完成顺序
   • 创建每个用户故事的并行执行示例
   • 验证任务完整性（每个用户故事有所有需要的任务，独立可测试）

4. 生成 tasks.md：使用 ${WAVE_PLUGIN_ROOT}/templates/tasks-template.md 作为结构，填写：

   • 来自 plan.md 的正确功能名称
   • 阶段 1：设置任务（项目初始化）
   • 阶段 2：基础任务（所有用户故事的阻塞性前置条件）
   • 阶段 3+：每个用户故事一个阶段（按 spec.md 优先级排序）
   • 每个阶段包括：故事目标、独立测试标准、测试（如请求）、实现任务
   • 最终阶段：完善与横切关注点
   • 所有任务必须遵循严格的检查清单格式（见下文任务生成规则）
   • 每个任务的清晰文件路径
   • 显示故事完成顺序的依赖章节
   • 每个故事的并行执行示例
   • 实现策略章节（MVP 优先、增量交付）

5. 报告：输出 tasks.md 的路径和摘要：

   • 总任务数
   • 每个用户故事的任务数
   • 识别的并行机会
   • 每个故事的独立测试标准
   • 建议的 MVP 范围（通常只是用户故事 1）
   • 格式验证：确认所有任务遵循检查清单格式（复选框、ID、标签、文件路径）

任务生成的上下文：$ARGUMENTS

tasks.md 应该立即可执行——每个任务必须足够具体，LLM 无需额外上下文即可完成。

任务生成规则

关键：任务必须按用户故事组织以实现独立实现和测试。

测试是可选的：仅在功能规格中明确请求或用户请求 TDD 方法时生成测试任务。

检查清单格式（必需）

每个任务必须严格遵循此格式：

- [ ] [任务ID] [P?] [故事?] 带文件路径的描述

格式组件：

1. 复选框：始终以 - [ ] 开头（markdown 复选框）
2. 任务 ID：执行顺序中的序列号（T001、T002、T003...）
3. [P] 标记：仅在任务可并行化时包含（不同文件，无未完成任务的依赖）
4. [故事] 标签：仅用户故事阶段任务需要
   • 格式：[US1]、[US2]、[US3] 等（映射到 spec.md 中的用户故事）
   • 设置阶段：无故事标签
   • 基础阶段：无故事标签
   • 用户故事阶段：必须有故事标签
   • 完善阶段：无故事标签
5. 描述：带确切文件路径的清晰操作

示例：

• ✅ 正确：- [ ] T001 根据实现计划创建项目结构
• ✅ 正确：- [ ] T005 [P] 在 src/middleware/auth.py 中实现认证中间件
• ✅ 正确：- [ ] T012 [P] [US1] 在 src/models/user.py 中创建用户模型
• ✅ 正确：- [ ] T014 [US1] 在 src/services/user_service.py 中实现用户服务
• ❌ 错误：- [ ] 创建用户模型（缺少 ID 和故事标签）
• ❌ 错误：T001 [US1] 创建模型（缺少复选框）
• ❌ 错误：- [ ] [US1] 创建用户模型（缺少任务 ID）
• ❌ 错误：- [ ] T001 [US1] 创建模型（缺少文件路径）

任务组织

1. 从用户故事（spec.md） - 主要组织：

   • 每个用户故事（P1、P2、P3...）有自己的阶段
   • 将所有相关组件映射到其故事：
     • 该故事需要的模型
     • 该故事需要的服务
     • 该故事需要的端点/UI
     • 如请求测试：该故事特定的测试
   • 标记故事依赖（大多数故事应该独立）

2. 从契约：

   • 将每个契约/端点 → 映射到它服务的用户故事
   • 如请求测试：每个契约 → 在该故事阶段实现前的契约测试任务 [P]

3. 从数据模型：

   • 将每个实体映射到需要它的用户故事
   • 如果实体服务于多个故事：放在最早的故事或设置阶段
   • 关系 → 适当故事阶段的服务层任务

4. 从设置/基础设施：

   • 共享基础设施 → 设置阶段（阶段 1）
   • 基础/阻塞任务 → 基础阶段（阶段 2）
   • 故事特定设置 → 在该故事阶段内

阶段结构

• 阶段 1：设置（项目初始化）
• 阶段 2：基础（阻塞性前置条件 - 必须在用户故事前完成）
• 阶段 3+：按优先级排序的用户故事（P1、P2、P3...）
  • 在每个故事内：测试（如请求）→ 模型 → 服务 → 端点 → 集成
  • 每个阶段应该是一个完整、独立可测试的增量
• 最终阶段：完善与横切关注点