plan

name	plan
description	实施计划技能。当用户要求制定实施计划、拆解任务、做技术方案设计时使用。必须基于已有的 spec 文档。触发词包括"写 plan"、"实施计划"、"任务拆解"、"技术方案"、"/plan"。

Plan - 实施计划技能

将已确认的 spec 文档转化为可执行落地的详细实施计划与任务清单。

核心原则

1. 不猜测：代码侧的技术细节遇到不确定的，必须向用户澄清
2. 不模糊：每个 TODO 子项必须描述清楚做什么、影响哪些文件、验收标准是什么
3. 不写代码：不写详细实现代码，但可以描述接口签名、数据结构、模块职责
4. 固定产出：输出到项目既有的需求目录；若无统一约定，建议使用 spec/<spec-name>/plan.md

前置条件

• 对应功能的 spec.md 必须已存在且状态为"已确认"
• 如果项目有统一文档目录，遵循现有约定；如果没有，建议使用 spec/<spec-name>/spec.md
• 如果 spec 不存在，提示用户先执行 /spec

工作流程

第一步：阅读上下文

1. 阅读对应功能的 spec.md
2. 阅读项目级背景文档（如 PRD、roadmap、里程碑文档；如果存在）
3. 阅读现有代码结构，理解当前架构、模块划分、命名规范
4. 阅读已有的其他 plan，理解整体技术方向一致性

第二步：技术澄清

1. 识别 spec 中在代码层面仍有歧义的点
2. 使用当前环境可用的提问方式向用户澄清技术选型、方案偏好
3. 反复澄清直到所有技术决策确定

第三步：撰写 Plan

按照下方固定模板撰写，写入对应功能的 plan.md。

第四步：用户确认

将产出交给用户确认，根据反馈修订直到用户满意。

固定模板

# <功能名称> 实施计划

> 关联 Spec：<spec 文档路径>
> 创建日期：YYYY-MM-DD
> 状态：草稿 | 已确认

## 1. 技术方案概述

用 1-3 段话概述整体技术实现思路。

## 2. 技术决策

### 2.1 方案选型
如有多种实现方案，列出各方案的优劣对比，并标注最终选择及理由。

### 2.2 外部依赖
列出需要引入的第三方库、服务、SDK、引擎能力或工具。

### 2.3 内部依赖
列出依赖的内部模块、已有接口、资源或数据结构。

## 3. 任务拆解

### 3.1 核心逻辑 / Runtime / 运行时模块（按项目实际情况命名）

- [ ] **TODO-S1: <任务标题>**
  - **描述**：详细说明要做什么
  - **涉及模块**：对应子系统、运行时模块或核心逻辑层
  - **涉及文件**：预估需要新建或修改的文件路径
  - **依赖**：依赖哪些前置 TODO（如 TODO-S0）
  - **验收标准**：完成后如何验证

- [ ] **TODO-S2: ...**

### 3.2 表现层 / Tooling / 工具模块（按项目实际情况命名）

- [ ] **TODO-C1: <任务标题>**
  - **描述**：详细说明要做什么
  - **涉及模块**：对应 UI 层、编辑器工具、页面、交互模块或辅助工具模块
  - **涉及文件**：预估需要新建或修改的文件路径
  - **依赖**：依赖哪些前置 TODO
  - **验收标准**：完成后如何验证

- [ ] **TODO-C2: ...**

### 3.3 共享 / 通用模块

- [ ] **TODO-G1: <任务标题>**
  - **描述**：类型定义、工具函数、配置、共享资源等通用部分
  - **涉及文件**：...
  - **依赖**：...
  - **验收标准**：...

## 4. 依赖关系与执行顺序

用文字或 ASCII 图描述 TODO 之间的依赖关系，标明哪些可以并行。

示例：
- TODO-G1 → TODO-S1（G1 完成后 S1 才能开始）
- TODO-S2 ‖ TODO-C1（可并行）

## 5. 测试标准

### 5.1 单元测试标准
逐条列出每个 TODO 需要的单元测试覆盖点。

### 5.2 集成 / 场景验证标准
描述完整流程的集成测试或场景验证，包括：
- 前置条件
- 操作步骤
- 期望结果
- 异常场景

## 6. 风险与缓解

| 风险 | 影响 | 缓解措施 |
|------|------|---------|

## 7. 开放问题

列出所有尚未解决的技术问题。如全部已解决则标注"无"。

关键约束

• TODO 颗粒度：每个 TODO 应该是一个开发者能在 1-4 小时内完成的工作单元
• 并行友好：不同层次或模块的 TODO 应尽量解耦，方便并行开发
• 测试先行：每个 TODO 必须附带验收标准，测试标准章节必须完整
• 不写实现代码：可以描述"创建一个 XxxManager / System / Service，提供核心方法或职责边界"，但不要写出具体实现