---
name: "stage-roadmap"
description: "总路线阶段技能 — 全面设计文档产出与版本路径规划。管理总路线阶段任务创建和阶段转换。"
---

# 总路线阶段

> 当 PM 检测到 Pipeline Tracker 标记为「总路线阶段」时调用本技能。
> 目标：产出完整的游戏设计文档体系，规划版本迭代路径。

---

## 阶段概述

| 项目 | 说明 |
|------|------|
| 目标 | 建立"这个游戏长什么样"的完整蓝图 |
| 产出 | 9 份设计文档 + 版本路径图 |
| 参与角色 | 策划（全部文档） |
| 完成标志 | 所有任务关闭 + 里程碑下无 open issues |

---

## 任务创建

### 检查已有任务

先通过 `issue list --milestone "总路线阶段" --state open` 检查现有任务，避免重复创建。

### 需要创建的任务（共 9 个）

**占位规则**：除系统设计文档（⑤）和关卡设计文档（⑥）必须完整内容外，其他文档允许暂时留空文件占位（包含标题、章节结构和「待填充」说明），后续迭代中逐步完善。

---

**任务 1：设计总索引文档** (D-XXX)

```bash
--title "D-XXX 设计总索引文档"
--body "## 任务信息
- **任务ID**: D-XXX
- **所属阶段**: 总路线阶段
- **角色**: 策划
- **优先级**: 最高（其他设计文档的索引基础）

## 预期产出
设计总索引 \`docs/design/设计总索引.md\`，包含：
- 所有设计文档的目录和链接
- 文档间的依赖关系图
- 当前完成状态追踪

## 占位规则
此文档必须完整产出（不允许占位）。"
--labels "stage:roadmap,role:design,status:ready"
--assignees "ai-designer"
```

**任务 2：世界观设计文档** (D-XXX) — 可占位

```
--title "D-XXX 世界观设计"
--body "...产出 docs/design/世界观设计.md
占位规则：允许占位（标题+章节结构+待填充说明）"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 3：剧情设计文档** (D-XXX) — 可占位

```
--title "D-XXX 剧情设计"
--body "...产出 docs/design/剧情设计.md
占位规则：允许占位"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 4：角色设计文档** (D-XXX) — 可占位

```
--title "D-XXX 角色设计"
--body "...产出 docs/design/角色设计.md
占位规则：允许占位"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 5：系统设计文档** (D-XXX) — ⚠️ 必须完整

```
--title "D-XXX 系统设计"
--body "...产出 docs/design/系统设计.md（含各子系统的设计）
⚠️ 不允许占位，必须产出完整内容。"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 6：关卡设计文档** (D-XXX) — ⚠️ 必须完整

```
--title "D-XXX 关卡设计"
--body "...产出 docs/design/关卡设计.md
⚠️ 不允许占位，必须产出完整内容。"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 7：UI 设计文档** (D-XXX) — 可占位

```
--title "D-XXX UI设计"
--body "...产出 docs/design/UI设计.md
占位规则：允许占位"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 8：音频设计文档** (D-XXX) — 可占位

```
--title "D-XXX 音频设计"
--body "...产出 docs/design/音频设计.md
占位规则：允许占位"
--labels "stage:roadmap,role:design,status:ready"
```

**任务 9：版本路径图** (D-XXX)

```
--title "D-XXX 版本路径图"
--body "...产出 docs/plans/版本路径图.md
包含：版本列表、每个版本的核心目标、范围概述、内容完成度、
涉及的系统清单、版本间递进逻辑、验收标准
依赖：任务 2-8（至少了解各文档的概要信息后才能规划版本路径）"
--labels "stage:roadmap,role:design,status:backlog"
```

### 依赖关系

```
任务 1（总索引）→ 先完成
任务 2-8（各设计文档）→ 1 完成后可并行创建，建议按序执行
任务 9（版本路径图）→ 依赖 2-8，最后完成
```

设置依赖：`issue block <任务9> <任务2>` ~ `issue block <任务9> <任务8>`

---

## 进度检查

每次 PM 激活时执行：

1. **读取任务状态**：`issue list --milestone "总路线阶段" --state open`
2. **判断当前焦点**：
   - 任务 1 未完成 → 建议：先完成设计总索引
   - 任务 2-8 有未完成的 → 建议按序完成各设计文档
   - 任务 2-8 全完成，任务 9 未开始 → 更新任务 9 为 `status:ready`
   - 任务 9 进行中 → 等待
3. **检查完成条件**：
   - 总路线阶段里程碑下 open issues = 0 → 触发阶段转换

---

## 阶段转换

**前置条件**：总路线阶段里程碑下无 open issues。

**转换操作**（每步需用户确认）：

```bash
# 1. 关闭总路线阶段里程碑
node scripts/gitea.js --role pm milestone update <总路线里程碑ID> --state closed

# 2. 创建第一个迭代版本里程碑
node scripts/gitea.js --role pm milestone create \
  --title "迭代-v0.1" \
  --description "第一个迭代版本"

# 3. 创建第一个迭代任务：插件资产检查与准备
# （详细参数见 stage-iteration 技能）

# 4. 更新 Pipeline Tracker
# 更新正文：当前阶段改为「迭代阶段」
# 阶段历史表添加总路线阶段完成日期

# 5. 告知用户已进入迭代阶段
# 下次 PM 激活时将调用 stage-iteration 技能
```