Claude Code Game Studios真实会话实录:从HUD哲学选择到/team-ui交接(16轮复盘)
【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios
Claude Code Game Studios 是一个把 Claude Code 变成完整游戏开发工作室的开源项目——49 个 AI 智能体、72 个工作流技能,按真实游戏公司的层级组织协作。本文带你逐轮复盘它的官方示例会话实录:一场 16 轮对话,从 HUD 哲学三选一,到库存屏幕设计、/ux-review审查拦截,最终交接给/team-ui团队技能。
📋 会话全景:一次完整的 UX 流水线
这场实录记录了一位独立开发者在预生产阶段设计游戏第一批 UI 的过程。完整记录在 session-ux-pipeline.md:
| 项目 | 内容 |
|---|---|
| 场景 | 生存题材游戏,HUD 与库存屏幕是第一批要设计的 UI |
| 起点 | 已有战斗 GDD、库存 GDD、玩家旅程文档,design/ux/目录尚不存在 |
| 耗时 | 约 90 分钟,横跨两次会话,共 16 轮对话 |
| 结果 | 生成design/ux/hud.md与design/ux/screens/inventory.md,并通过审查交接给/team-ui |
整个流程串起三个技能:/ux-design(分节写作 UX 规格)→/ux-review(审查硬门槛)→/team-ui(团队编排落地)。它们的技能规范分别见 ux-design.md、ux-review.md 和 team-ui.md。
🎯 第 1–3 轮:HUD 哲学三选一
用户输入只有一个命令:
/ux-design hud
接下来发生的事,是新手最容易低估的部分。智能体(ux-designer)先读上下文再提问(session-ux-pipeline.md#L27-L41):
- 从
design/player-journey.md提取玩家情绪状态:平静探索、紧张、危机、战斗 - 从战斗 GDD 提取 HUD 需求:血条、体力条、最多 3 个技能冷却、伤害数字
- 从库存 GDD 提取:4 个快捷槽位、当前道具指示
然后它不直接开始写,而是抛出一个哲学级问题:
HUD Philosophy question:玩家在游玩时的主要注意力焦点是什么?
- A:Diegetic(低存在感)——只在受伤时显示血量,HUD 隐入世界
- B:Persistent minimal(常驻极简)——血量和体力始终可见但小巧不抢镜
- C:Full tactical(全战术)——所有信息常驻,玩家随时掌握全局
考虑到你的生存题材和"孤独幸存者"幻想,A 或 B 更符合类型惯例。
用户回复:"B——我想要的是一直在那,但保持极简。玩家始终在管理资源。"
第 3 轮,智能体给出哲学段落草稿,并遵循协作协议中的关键一步——"May I write this todesign/ux/hud.md?",得到用户点头才动笔。这就是这个项目反复强调的原则:智能体是顾问,不是自动驾驶(详见 COLLABORATIVE-DESIGN-PRINCIPLE.md)。
✍️ 第 4–12 轮:分节写作,每个决定都先落盘
HUD 与库存屏幕的写作都采用同一套**骨架优先(skeleton-first)**节奏:
- 先建文件、写满所有章节标题
- 逐节讨论 → 逐节起草 → 逐节确认后立即写入磁盘
- 每节都单独征求一次写入许可
HUD 依次完成六个章节(session-ux-pipeline.md#L65-L77):
| 章节 | 关键产出 |
|---|---|
| 信息架构 | 血量左上、快捷槽底中、冷却右下、伤害数字世界空间 |
| 区域划分 | 4 个显示区域 |
| 元素规格 | 6 个元素的尺寸、字号、透明度规则 |
| 状态机 | 平静 / 紧张 / 危机 / 战斗 4 态及切换触发 |
| 视觉预算 | 屏幕覆盖率 ≤ 8%,同时动画 ≤ 3 个 |
| 平台适配 | 手柄版增加准星,移动端 v1 不在范围内 |
这种"每节即落盘"的模式有两个实际好处:会话崩溃随时可从第一个空节恢复,且避免长文档把上下文撑爆。
第 8–12 轮,同样的循环用于库存屏幕。当被问到"玩家如何触发道具操作"时,用户选择了B:拖拽式(Stardew Valley 风格)——"我想要有触感"。
🛑 第 13–15 轮:/ux-review 硬门槛拦截
设计完成后,用户运行/ux-review design/ux/。审查结果不是一句"看起来不错",而是一张逐项打勾的清单(session-ux-pipeline.md#L127-L159):
| 检查项 | HUD | 库存屏幕 |
|---|---|---|
| GDD 对齐、元素齐全 | ✅ | ✅ |
| 无障碍层级 | ⚠️ 血条仅用红/黄表意,缺色盲模式 | ❌缺键盘替代路径 |
| 拖拽交互完整度 | — | ⚠️ 背包满时的落点行为未定义 |
Verdict: NEEDS REVISION
审查最有价值的地方在于问题分级:
- 🔴BLOCKING(阻断):库存屏幕只有拖拽、没有键盘路径,直接违反运动无障碍要求——不解决就不许交接
- 🟡ADVISORY(建议):色盲模式、背包满行为——可在后续视觉阶段处理
用户一句话解决了阻断项(按 F 拾取/放置),智能体更新交互地图并重跑无障碍检查——一轮之内,通过。
💡 这就是"设计时拦截"的威力:一个本要留到发布前 QA 才暴露的无障碍缺陷,在 90 分钟的会话里就被关闭了。
🤝 第 16 轮:/team-ui 接管交接
最后一轮只输入了/team-ui。注意它的第一件事——上下文检查(session-ux-pipeline.md#L187-L198):
design/ux/hud.md— reviewed ✅design/ux/screens/inventory.md— reviewed ✅/ux-reviewverdict:NEEDS REVISION 已解决,当前状态APPROVED✅进入Phase 2: Visual Design,移交给
art-director制定视觉规格……
/team-ui是一个五阶段团队编排技能:上下文收集 → UX 审查硬门槛 → 视觉设计(art-director)→ 实现(ui-programmer)→ 并行审查(ux-designer + art-director + accessibility-specialist)→ 打磨。它的完整阶段定义与"审查未过则停线"的协议,可查阅 team-ui.md。
✅ 这场实录教会新手的关键点
- 上下文驱动设计:HUD 决策的锚点是玩家旅程文档里的情绪状态,不是功能清单
- 审查是硬门槛:
/team-ui会验证/ux-review是否通过,未通过绝不进入视觉设计 - 阻断 vs 建议:BLOCKING 停线,ADVISORY 可延后——问题分级让修复不慌不乱
- 每节先审批后落盘:协作协议(提问 → 选项 → 决策 → 草稿 → 批准)贯穿全程,用户始终握有决定权
- 模式沉淀:库存拖拽交互此后会进入
design/ux/interaction-patterns.md,供所有后续屏幕复用
🚀 想自己跑一遍?三步上手
- 克隆仓库:
git clone https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios my-game cd my-game启动会话:安装 Claude Code 后运行
claude,输入/start。系统会先问你当前处于哪个阶段(没想法 / 模糊概念 / 清晰设计 / 已有代码),再引导到对应工作流。直达 UX 流水线:如果你已有 GDD,可以直接
/ux-design hud→/ux-review design/ux/→/team-ui,完整复现本文的 16 轮流程。
📚 延伸阅读
- session-ux-pipeline.md:本场 16 轮会话的完整实录
- skill-flow-diagrams.md:7 个开发阶段、72 个技能如何串联的可视化地图
- examples/README.md:全部 9 个官方会话实录的导读
- WORKFLOW-GUIDE.md:从概念到发布的完整工作流指南
- CLAUDE.md:整个工作室的主配置与协作协议
【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考