game-ui-product-design

游戏策划 · PRD · UI 交互（生成第一步）

本技能是完整 UI 生成流程的第一步。 在调用页面生图、风格切换或批量延展之前，必须先完成本步并请用户批准三份文档。没有批准（且用户未明确跳过）时，不得开始后续视觉生成。

输出文件

写入 specs/<project-id>/：

文件	中文名	用途
gdd.md	游戏策划方案	定位、核心循环、系统清单、经济与养成（策划层）
prd.md	产品需求文档	P0/P1 需求、信息架构、交付范围、验收
interaction.md	UI 交互逻辑	导航、主流程、控件行为、状态机、跨页链路

模板来源：仓库 templates/spec-kit/gdd.md、prd.md、interaction.md。项目已初始化则直接编辑现有文件，不要另起平行文档。

何时使用

• 任何完整生成流程的第一步（默认入口）
• 新建 UI 项目、只有概念尚无视觉
• 用户要求「生成之前加策划 / PRD / 交互」
• 延展或生图前发现三文档缺失、draft 或内容空洞
• 玩法或页面范围变更，需要回写需求与交互

输入

优先读取：

• spec.md、research.md、plan.md
• 已有的 gdd.md / prd.md / interaction.md
• 若已有：contracts/screen-contract.yaml

信息不足时：只询问题材、平台、核心玩法、首发页面范围等阻断问题；其余给可调整默认值并标注。

工作流

复制并跟踪：

进度:
- [ ] 1. 确认或初始化项目目录
- [ ] 2. 撰写/更新 gdd.md
- [ ] 3. 撰写/更新 prd.md
- [ ] 4. 撰写/更新 interaction.md
- [ ] 5. 交叉检查三文档一致
- [ ] 6. 停在人工批准门禁

1. 项目目录

若 specs/<project-id>/ 不存在：

python3 scripts/init_project.py <project-id>

2. gdd.md（游戏策划方案）

必须覆盖：

• 一句话定位、目标用户、卖点（≤3）
• 核心循环表（回流 → 准备 → 玩法 → 成长 → 商业）
• 系统清单与优先级（must-have / genre-specific / optional）
• 资源与经济（策划层概述，禁止假装已有服务端公式）
• 养成与进度轴、世界观最小集、风险约束

文档状态.status 先保持 draft，待用户批准后再改 approved。

3. prd.md（产品需求）

必须覆盖：

• 产品目标与可验证成功指标
• 非目标（明确不做）
• P0 / P1 / P2 需求表（每条对应页面或系统）
• 信息架构与本迭代页面交付范围
• 数据依赖、边界异常、验收清单

每条 P0 必须能被后续某个 screen-id 承接。

4. interaction.md（UI 交互逻辑）

必须覆盖：

• 全局交互原则、全局导航、全局状态
• 每个 must-have 页面：目的、进出、主流程、控件表、状态机
• 跨页链路（至少核心循环相关）
• 「与视觉稿的约束」：首屏必露信息、禁遮挡区、主操作强调

状态名尽量与后续 screen-contract.yaml 的 states 一致（如 default / loading / incomplete / low-currency）。

5. 交叉检查

• gdd 核心循环中的界面 ⊆ prd 页面范围
• prd P0 页面 ⊆ interaction 分页面章节
• 商业/破坏性操作在 interaction 中有确认或失败路径
• 三文档互不矛盾；空洞模板不得标为 approved

6. 人工门禁（必须停止）

完成后输出：

当前步骤：第 1 步 · 策划与 PRD / 交互逻辑（生成第一步）
完成状态：draft，等待批准
本步产物：gdd.md、prd.md、interaction.md
需要你检查：定位与循环、P0 范围、分页面主流程与状态
可选操作：修改文案 / 增删系统 / 批准三文档 / 明确跳过门禁
进入下一步的条件：三文档 status 均为 approved，或 quickstart.md 记录跳过原因
可直接复制的下一步调用文本：
批准 @specs/<project-id>/gdd.md、prd.md、interaction.md。
批准后进入第 2 步：使用 game-ui-workflow 生成基准页原型视觉。