DESKTOP-2K5TJI4\admin
5.3 KiB
5.3 KiB
name, description
| name | description |
|---|---|
| stage-roadmap | 总路线阶段技能 — 全面设计文档产出与版本路径规划。管理总路线阶段任务创建和阶段转换。 |
总路线阶段
当 PM 检测到 Pipeline Tracker 标记为「总路线阶段」时调用本技能。 目标：产出完整的游戏设计文档体系，规划版本迭代路径。
阶段概述
| 项目 | 说明 |
|---|---|
| 目标 | 建立"这个游戏长什么样"的完整蓝图 |
| 产出 | 9 份设计文档 + 版本路径图 |
| 参与角色 | 策划（全部文档） |
| 完成标志 | 所有任务关闭 + 里程碑下无 open issues |
任务创建
检查已有任务
先通过 issue list --milestone "总路线阶段" --state open 检查现有任务，避免重复创建。
需要创建的任务（共 9 个）
占位规则：除系统设计文档（⑤）和关卡设计文档（⑥）必须完整内容外，其他文档允许暂时留空文件占位（包含标题、章节结构和「待填充」说明），后续迭代中逐步完善。
任务 1：设计总索引文档 (D-XXX)
--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 激活时执行：
- 读取任务状态：
issue list --milestone "总路线阶段" --state open - 判断当前焦点：
- 任务 1 未完成 → 建议：先完成设计总索引
- 任务 2-8 有未完成的 → 建议按序完成各设计文档
- 任务 2-8 全完成，任务 9 未开始 → 更新任务 9 为
status:ready - 任务 9 进行中 → 等待
- 检查完成条件：
- 总路线阶段里程碑下 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 技能