project-planning

委派

对于详细的任务规划工作流，此技能会委派给 spec-kit:task-planning，将其作为规范实现。快速规划需求请使用此技能；全面的项目计划请使用 spec-kit。

适用场景

• 规格说明阶段完成后
• 需要设计系统架构
• 需要拆分实现任务
• 规划冲刺和资源分配
• 将需求转化为具体任务
• 定义组件接口和依赖关系

不适用场景

• 尚无规格说明（请先使用 Skill(attune:project-specification)）
• 仍在探索问题空间（请改用 Skill(attune:project-brainstorming)）
• 已准备好执行现有计划（请改用 Skill(attune:project-execution)）
• 需要调整正在进行的项目（增量更新计划，不要重新开始）

集成

使用 superpowers 时：

• 使用 Skill(superpowers:writing-plans) 进行结构化规划
• 应用基于检查点的执行模式
• 使用依赖关系分析框架

不使用 superpowers 时：

• 独立的规划方法
• 任务拆分模板
• 依赖关系跟踪模式

质量检查

完成计划前：

• ✅ 已记录所有架构组件
• ✅ 任务开始前已包含 File Structure 部分
• ✅ File Structure 表中列出了所有任务文件
• ✅ 所有 FR 均已映射到任务
• ✅ 所有任务均有验收标准
• ✅ 依赖关系无环
• ✅ 已提供工作量估算
• ✅ 已确定关键路径
• ✅ 已评估风险并制定缓解措施
• ✅ 各冲刺的工作量与产能相匹配

记录权衡（决策日志）

规划阶段会做出架构和范围决策：选择的模式、接受的依赖、推迟的工作。请将每项存在实际备选方案的决策记录到 docs/tradeoffs.md（先起草，再确认）：

• 如果已安装 leyline，请调用 Skill(leyline:decision-journal) 并追加一条权衡记录（包括决策、权衡过的选项以及做出的牺牲；将 phase 设为 plan）。显示草稿；确认后再追加。
• 备用方案（未安装 leyline）：使用文件内的 ENTRY TEMPLATE 追加到 docs/tradeoffs.md；分配下一个 TR-NNN ID。

完成后：继续工作流（必需）

自动触发：通过质量检查并保存 docs/implementation-plan.md 后，必须自动调用下一阶段。

调用继续流程时：

1. 验证 docs/implementation-plan.md 存在且非空
2. 向用户显示检查点消息：

   Implementation plan complete. Saved to docs/implementation-plan.md.
   Proceeding to execution phase...
   

3. 调用下一阶段：

   Skill(attune:project-execution)
   

跳过条件（仅在满足以下任一条件时跳过继续流程）：

• 用户提供了 --standalone 标志
• docs/implementation-plan.md 不存在或为空（阶段失败）
• 用户明确要求规划后停止

不要请求用户确认：这是一个轻量级检查点，而非交互式关卡。如有需要，用户随时可以中断。

退出标准

• docs/implementation-plan.md 存在、非空且通过质量检查（依赖关系无环、FR 已映射、已确定关键路径）。
• 架构和范围决策及其备选方案均已记录到 docs/tradeoffs.md。
• 除非满足跳过条件，否则会自动调用执行阶段。

相关技能

• Skill(superpowers:writing-plans) - 规划方法（如可用）
• Skill(spec-kit:task-planning) - 任务拆分（如可用）
• Skill(attune:project-specification) - 上一阶段
• Skill(attune:project-execution) - 规划后的下一阶段（自动调用）
• Skill(attune:mission-orchestrator) - 全生命周期编排

相关命令

• /attune:blueprint - 调用此技能
• /attune:execute - 工作流的下一步

示例

完整示例请参阅 /attune:blueprint 命令文档。

故障排除

常见问题

如果发现任务图中存在循环依赖，请将其中一个任务拆分为更小的子任务。如果持续超出冲刺容量，请使用斐波那契数列重新估算任务，或缩减冲刺范围。