game-ui-workflow

游戏 UI 总控工作流

把对话需求转换成可复现的 UI 项目。项目事实必须写入 specs/<project-id>/；不要仅保留在对话中。

快速路由

根据请求选择最小充分路径：

• 游戏策划、PRD、交互逻辑、生图前需求 → game-ui-product-design
• 规范、设计系统、统一风格 → game-ui-specification
• 页面清单、功能扩展、玩家旅程 → game-ui-extension
• 完整单页、原型视觉、页面生图 → game-ui-page-generator
• 透明组件、切图、素材拆解 → game-ui-component-breakdown
• 雪碧图、单元素 PNG、切片打包 → game-ui-sprite-sheet-splitter
• Atlas、9-slice、Godot / Unity / Cocos JSON → game-ui-asset-pipeline
• 完整项目或多阶段交付 → 按本工作流依次编排

用户明确要求单阶段时，不强迫执行完整流程；但要读取已有契约。 生图前若 gdd.md / prd.md / interaction.md 缺失或仍为 draft，必须先执行生成第一步：game-ui-product-design。

分步操作指引

当用户按完整生成链路工作时，第一步必须是策划与 PRD，使用以下检查点：

1. 策划与 PRD（生成第一步）：调用 game-ui-product-design，完成并批准 gdd.md、prd.md、interaction.md；未批准前不得进入后续生图步骤。
2. 原型生成视觉：用一个基准页面验证构图和信息层级，保存为未批准版本。
3. UI 风格切换：保持页面结构不变生成风格候选；用户选定后再批准样式契约和基准页。
4. UI 延展：先输出屏幕地图并等待范围确认，再按批次逐页生成。
5. UI 组件拆解：只拆已批准页面，每个组件和状态单独交付。
6. 雪碧图拆分打包：把组件合图切成单元素透明 PNG，生成 manifest 和 ZIP。
7. Atlas 与引擎交付：语义命名、确认 9-slice、打包 Atlas 并生成引擎 JSON。

每一步开始时简要说明：

• 当前步骤和目标
• 将读取的输入
• 将产生或修改的文件
• 本步停止条件

每一步结束时固定输出：

当前步骤：
完成状态：
本步产物：
需要你检查：
可选操作：
进入下一步的条件：
可直接复制的下一步调用文本：

存在人工门禁时必须停止，不能把“给出下一步指引”理解为自动执行下一步：

• gdd.md / prd.md / interaction.md 未批准时，不开始页面生图（用户明确要求“跳过策划门禁”除外，并写入 quickstart.md）。
• 原型结构未确认时，不开始风格定稿。
• 风格契约和基准页未批准时，不批量延展页面视觉。
• 页面范围未确认时，只完成屏幕地图。
• 源页面未批准时，不拆组件。
• 组件雪碧图不存在时，不伪造单元素 PNG 或 ZIP。
• 语义 mapping 和 9-slice 未审核时，不批准 Atlas 或引擎清单。

初始化

1. 生成稳定的 project-id，使用小写字母、数字和连字符。

2. 若项目目录不存在，执行：

   python3 scripts/init_project.py <project-id>
   

3. 读取 spec.md、research.md、plan.md、gdd.md、prd.md、interaction.md 和 contracts/ 中全部文件。

4. 将用户提供的参考图路径记入 spec.md，分析结论写入 research.md。

5. 只询问会改变题材、平台、比例或交付范围的阻断问题；其他信息使用明确标注的默认值。

阶段顺序

完整项目启动时，生成链路从 Product Design 开始（第一步）。spec.md / research.md 可在同一步由产品设计回填最小集，或紧随其后补全。

1. Product Design（生成第一步）

调用 game-ui-product-design：

1. 写入 gdd.md：游戏定位、核心循环、系统清单、经济与养成（策划层，不含服务端公式）
2. 写入 prd.md：P0/P1 需求、信息架构、页面交付范围、验收标准
3. 写入 interaction.md：全局导航、分页面主流程、控件行为、状态机、跨页链路
4. 若 spec.md 仍空，同步写入项目定位、平台、比例与范围摘要