ChildHood/.claude/skills/stage-roadmap.md

name, description

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

总路线阶段

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

---

阶段概述

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

---

任务创建

检查已有任务

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

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

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

---

设计总索引文档 (D-XXX)

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

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

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

世界观设计文档 (D-XXX) — 可占位

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

剧情设计文档 (D-XXX) — 可占位

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

角色设计文档 (D-XXX) — 可占位

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

系统设计文档 (D-XXX) — ⚠️ 必须完整

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

关卡设计文档 (D-XXX) — ⚠️ 必须完整

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

UI 设计文档 (D-XXX) — 可占位

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

音频设计文档 (D-XXX) — 可占位

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

版本路径图 (D-XXX)

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

依赖关系

设计总索引 → 先完成
各设计文档（世界观/剧情/角色/系统/关卡/UI/音频）→ 索引完成后可并行创建，建议按序执行
版本路径图 → 依赖所有设计文档，最后完成

设置依赖：issue block <版本路径图> <世界观> ~ issue block <版本路径图> <音频>

---

进度检查

每次 PM 激活时执行：

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

---

阶段转换

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

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

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

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

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

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

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