task-planning

任务规划

概述

将规范和实施计划转化为具体的、按依赖关系排序的任务。创建分阶段拆解方案，指导系统化实施。

适用场景

• 将规范转化为实施任务
• 规划功能实施顺序
• 识别并行执行的机会
• 将复杂功能拆分为多个阶段

不适用场景

• 编写规范——请使用 spec-writing

任务阶段

任务遵循从准备到完善的 5 阶段结构：

• 阶段 1：准备 - 项目初始化、依赖项、配置
• 阶段 2：基础 - 数据模型、接口、测试基础设施
• 阶段 3：核心实施 - 业务逻辑、API、服务
• 阶段 4：集成 - 外部服务、中间件、日志记录
• 阶段 5：完善 - 优化、文档、最终测试

有关详细的阶段定义、选择指南和反模式，请参阅 modules/phase-structure.md。

任务格式

每项任务包含：

• ID：唯一标识符（T001）
• 描述：清晰的行动说明
• 阶段：所属阶段
• 依赖项：必须先完成的任务
• 并行标记：可并发执行时标记为 [P]
• 文件：受影响的文件路径
• 验收标准：验证完成情况的方法

依赖规则

依赖项用于定义执行顺序并识别并行化机会：

• 顺序执行的任务：存在依赖项时，严格按顺序执行
• 并行任务 [P]：仅在满足所有无冲突条件时，才能并发执行
• 文件协调：影响相同文件的任务必须按顺序执行

并行执行的无冲突标准：

• ✅ 文件：任务之间没有文件重叠
• ✅ 状态：没有共享配置或全局状态
• ✅ 依赖项：所有前置条件均已满足
• ✅ 代码路径：不会产生合并冲突
• ✅ 输出：任务不需要彼此的结果

仅当任务满足上述所有标准时，才标记为 [P]。

有关扇出/扇入模式、任务 ID 约定和验证规则，请参阅 modules/dependency-patterns.md。

任务条目示例

## Phase 3: Core Implementation

### T007 - Implement user authentication service [P]
**Dependencies**: T003, T004
**Files**: src/services/auth.ts, src/types/user.ts
**Criteria**: All auth tests pass, tokens are valid JWT

**验证：**运行 pytest -v 以确认测试通过。

质量检查清单

• 所有需求都已映射到任务
• 依赖项均已明确
• 已识别并行执行的机会
• 任务规模适当（不过大或过小）
• 每项任务都有明确的完成标准

相关技能

• spec-writing：创建源规范
• speckit-orchestrator：工作流协调

退出标准

• 每项任务都有符合 TNNN 格式（T001）的唯一 ID，并包含 描述、阶段（1-5）、依赖项列表、并行标记 （[P] 或顺序执行）、文件和验收标准字段
• 标记为 [P] 的任务满足全部 5 项无冲突标准：没有文件 重叠、没有共享状态、依赖项均已满足、不可能产生合并 冲突，且任务之间没有输出依赖关系
• 源规范中的每项功能需求都至少映射到一项任务；未映射的需求已标记
• 输出最终确定前，质量检查清单中的所有项目均已通过
• 每个阶段内的任务均已排序，确保没有任务依赖同一阶段中 编号更大的任务