task-plannerlisted

# 任务规划器 (Task Planner) > **版本**: 2.0.0 | **十步循环**: A.2 + A.3 (Agent 预分配) > **架构**: 双层任务架构 (tasks.md + detailed-tasks.yaml) ## 快速开始 ### 我应该使用这个 Skill 吗？ **使用场景**: - A.2: 将 OpenSpec proposal.md 分解为可执行任务 - 需要评估任务复杂度和工作量 - 需要分析任务间依赖关系 - 需要确定最优执行顺序 - 需要预分配执行 Agent **不使用场景**: - 创建 Spec → 使用 `spec-drafter` (A.1) - 查询项目状态 → 使用 `state-scanner` (A.0) - 创建功能分支 → 使用 `branch-manager` (B.1) --- ## 核心功能 | 功能 | 描述 | |------|------| | **双层架构** | tasks.md (粗粒度) + detailed-tasks.yaml (细粒度) | | tasks.md 解析 | 读取 OpenSpec 标准格式的 tasks.md，提取功能清单 | | 任务转换 | 将功能清单转换为原子化任务 (4-8h 粒度) | | parent 链接 | 维护 tasks.md 编号与 TASK-{NNN} 的映射关系 | | 复杂度评估 | 自动评估 S/M/L/XL 复杂度 | | 依赖分析 | 识别任务间依赖，构建 DAG | | Agent 预分配 | 根据任务类型建议 Agent | | 状态跟踪 | 为每个任务添加 status 字段 | --- ## 执行流程 ### A.2.1 - 读取 Spec (tasks.md 优先) ```yaml 输入: - spec_path: Spec 目录路径 (如 changes/user-auth/) 读取策略: IF tasks.md 存在: → 路径 A: 解析 tasks.md (OpenSpec 标准格式) → 输出: 双层架构 ELSE: → 路径 B: 从 proposal.md 分解任务 → 输出: 仅 detailed-tasks.yaml 始终从 proposal.md 读取 ## Success Criteria 章节 ``` **详细解析流程**: [DUAL_LAYER_SPEC.md](./DUAL_LAYER_SPEC.md) ### A.2.2 - 任务分解 ```yaml 分解规则: 粒度目标: 4-8 小时可完成 原子性: 单一职责，便于验证 可测试: 每个任务有明确验收标准 分解策略: XL/L 任务: 按功能模块/技术层级拆分 M 任务: 按实现步骤拆分 S 任务: 保持原样 ``` ### A.2.3 - 复杂度评估 | 维度 | S | M | L | XL | |------|---|---|---|-----| | 文件影响 | 1-2 | 3-5 | 6-10 | >10 | | 依赖数量 | 0 | 1-2 | 3-4 | >4 | **详细评估规则**: [COMPLEXITY_GUIDE