Prompt file imported from Wike-CHI/timao-douyin-live-manager (
.cursor/commands/speckit.tasks.md). Fill in{{arguments}}before use. Copyright stays with the author.
用户输入
{{arguments}}如果用户输入不为空，您必须在继续之前考虑用户输入。
概述
-
设置: 从仓库根目录运行
.specify/scripts/powershell/check-prerequisites.ps1 -Json，并解析 FEATURE_DIR 和 AVAILABLE_DOCS 列表。所有路径必须是绝对的。对于像 "I'm Groot" 这样的单引号参数，使用转义语法：例如 'I'''m Groot'（或如果可能，使用双引号："I'm Groot"）。 -
加载设计文档: 从 FEATURE_DIR 读取：
- 必需: plan.md（技术栈、库、结构）, spec.md（带优先级的用户故事）
- 可选: data-model.md（实体）, contracts/（API 端点）, research.md（决策）, quickstart.md（测试场景）
- 注意：并非所有项目都有所有文档。根据可用内容生成任务。
-
执行任务生成工作流：
- 加载 plan.md 并提取技术栈、库、项目结构
- 加载 spec.md 并提取用户故事及其优先级（P1, P2, P3 等）
- 如果 data-model.md 存在: 提取实体并映射到用户故事
- 如果 contracts/ 存在: 将端点映射到用户故事
- 如果 research.md 存在: 提取设置任务的决策
- 按用户故事组织生成任务（参见下面的任务生成规则）
- 生成显示用户故事完成顺序的依赖图
- 为每个用户故事创建并行执行示例
- 验证任务完整性（每个用户故事都有所有需要的任务，可独立测试）
-
生成 tasks.md: 使用
.specify.specify/templates/tasks-template.md作为结构，填充：- 来自 plan.md 的正确功能名称
- 阶段 1: 设置任务（项目初始化）
- 阶段 2: 基础任务（阻塞所有用户故事的先决条件）
- 阶段 3+: 每个用户故事一个阶段（按 spec.md 中的优先级顺序）
- 每个阶段包括: 故事目标、独立测试标准、测试（如请求）、实施任务
- 最后阶段: 完善与跨领域关注点
- 所有任务必须遵循严格的检查清单格式（参见下面的任务生成规则）
- 每个任务的清晰文件路径
- 显示故事完成顺序的依赖部分
- 每个故事的并行执行示例
- 实施策略部分（MVP 优先，增量交付）
-
报告: 输出生成的 tasks.md 的路径和摘要：
- 总任务数
- 每个用户故事的任务数
- 识别的并行机会
- 每个故事的独立测试标准
- 建议的 MVP 范围（通常只是用户故事 1）
- 格式验证: 确认所有任务遵循检查清单格式（复选框、ID、标签、文件路径）
任务生成上下文：{{arguments}}
tasks.md 应该立即可执行 - 每个任务必须足够具体，以便 LLM 可以在没有额外上下文的情况下完成它。
任务生成规则
关键: 任务必须按用户故事组织，以支持独立实施和测试。
测试是可选的: 仅在功能规格中明确请求或用户请求 TDD 方法时生成测试任务。
检查清单格式（必需）
每个任务必须严格遵循此格式：
- [ ] [TaskID] [P?] [Story?] 带文件路径的描述格式组件：
- 复选框: 始终以
- [ ]开头（markdown 复选框） - 任务 ID: 执行顺序中的顺序编号（T001, T002, T003...）
- [P] 标记: 仅在任务可并行化时包含（不同文件，不依赖未完成的任务）
- [Story] 标签: 仅对用户故事阶段任务必需
- 格式: [US1], [US2], [US3] 等（映射到来自 spec.md 的用户故事）
- 设置阶段: 无故事标签
- 基础阶段: 无故事标签
- 用户故事阶段: 必须有故事标签
- 完善阶段: 无故事标签
- 描述: 带有确切文件路径的清晰操作
示例：
- ✅ 正确:
- [ ] T001 根据实施计划创建项目结构 - ✅ 正确:
- [ ] T005 [P] 在 src/middleware/auth.py 中实现认证中间件 - ✅ 正确:
- [ ] T012 [P] [US1] 在 src/models/user.py 中创建 User 模型 - ✅ 正确:
- [ ] T014 [US1] 在 src/services/user_service.py 中实现 UserService - ❌ 错误:
- [ ] 创建 User 模型（缺少 ID 和 Story 标签） - ❌ 错误:
T001 [US1] 创建模型（缺少复选框） - ❌ 错误:
- [ ] [US1] 创建 User 模型（缺少任务 ID） - ❌ 错误:
- [ ] T001 [US1] 创建模型（缺少文件路径）
任务组织
-
来自用户故事（spec.md） - 主要组织：
- 每个用户故事（P1, P2, P3...）获得自己的阶段
- 将所有相关组件映射到其故事：
- 该故事所需的模型
- 该故事所需的服务
- 该故事所需的端点/UI
- 如果请求测试: 特定于该故事的测试
- 标记故事依赖（大多数故事应该是独立的）
-
来自契约：
- 将每个契约/端点 → 映射到它服务的用户故事
- 如果请求测试: 每个契约 → 在该故事阶段实施之前的契约测试任务 [P]
-
来自数据模型：
- 将每个实体映射到需要它的用户故事
- 如果实体服务于多个故事: 放在最早的故事或设置阶段
- 关系 → 在适当故事阶段的服务层任务
-
来自设置/基础设施：
- 共享基础设施 → 设置阶段（阶段 1）
- 基础/阻塞任务 → 基础阶段（阶段 2）
- 故事特定设置 → 在该故事的阶段内
阶段结构
- 阶段 1: 设置（项目初始化）
- 阶段 2: 基础（阻塞先决条件 - 必须在用户故事之前完成）
- 阶段 3+: 按优先级顺序的用户故事（P1, P2, P3...）
- 在每个故事内: 测试（如请求） → 模型 → 服务 → 端点 → 集成
- 每个阶段应该是完整的、可独立测试的增量
- 最后阶段: 完善与跨领域关注点
