Claude Code Game Studios:让 Claude Code 变成完整游戏开发工作室
posts posts 2026-03-26T17:50:00+08:00深入分析 Claude Code Game Studios 项目:48个AI Agent、37个工作流技能、完整的工作室协调系统,将单个 Claude Code 会话变成一个完整游戏开发团队。技术笔记AI, Claude Code, 游戏开发, 多Agent, 工作流, Agent协作目录
Claude Code Game Studios:让 Claude Code 变成完整游戏开发工作室
难度:⭐⭐⭐⭐ | 类型:专家设计 | 预计阅读时间:45 分钟 目标读者:游戏开发者、AI Agent 研究者、使用 Claude Code 的技术团队
🎯 概述:一个会话 → 一个工作室
Claude Code Game Studios 是一个将单个 Claude Code 会话转变为一个完整游戏开发工作室的开源模板。
它的核心思路非常清晰:
不再是一个全能的通用助手,而是一个有层级、有分工、有质量门禁的专业团队。
| 核心数据 | 数值 |
|---|---|
| 🤖 Agent 数量 | 48 个 |
| ⚡ 工作流技能 | 37 个 |
| 🪝 自动化钩子 | 8 个 |
| 📐 路径规则 | 11 条 |
| 📄 文档模板 | 29 个 |
🏛️ 工作室层级架构
三层分工体系
项目采用真实游戏工作室的层级结构,分为三个层级:
┌─────────────────────────────────────────────────────────────┐
│ Tier 1 — 导演团(Opus) │
│ creative-director technical-director producer │
├─────────────────────────────────────────────────────────────┤
│ Tier 2 — 部门主管(Sonnet) │
│ game-designer lead-programmer art-director │
│ audio-director narrative-director qa-lead │
│ release-manager localization-lead │
├─────────────────────────────────────────────────────────────┤
│ Tier 3 — 专家专员(Sonnet/Haiku) │
│ gameplay-programmer engine-programmer ai-programmer │
│ network-programmer tools-programmer ui-programmer │
│ systems-designer level-designer economy-designer │
│ technical-artist sound-designer writer world-builder │
│ ux-designer prototyper performance-analyst │
│ devops-engineer analytics-engineer security-engineer │
│ qa-tester accessibility-specialist live-ops-designer │
└─────────────────────────────────────────────────────────────┘引擎专家分组
模板还包含三大主流引擎的专属 Agent 组合:
| 引擎 | 首席 Agent | 专项专家 |
|---|---|---|
| Godot 4 | godot-specialist | GDScript、Shaders、GDExtension |
| Unity | unity-specialist | DOTS/ECS、Shaders/VFX、Addressables、UI Toolkit |
| Unreal Engine 5 | unreal-specialist | GAS、Blueprints、Replication、UMG/CommonUI |
⚡ 37 个工作流技能
通过 / 斜杠命令访问所有技能,分为六大类:
📋 评审与分析
| 技能 | 用途 |
|---|---|
/design-review | 设计评审 |
/code-review | 代码评审 |
/balance-check | 游戏平衡性检查 |
/asset-audit | 资源审计 |
/scope-check | 范围检查 |
/perf-profile | 性能分析 |
/tech-debt | 技术债务分析 |
🏭 生产管理
| 技能 | 用途 |
|---|---|
/sprint-plan | Sprint 规划 |
/milestone-review | 里程碑评审 |
/estimate | 工作量估算 |
/retrospective | 回顾会议 |
/bug-report | Bug 报告 |
📁 项目管理
| 技能 | 用途 |
|---|---|
/start | 项目启动引导 |
/project-stage-detect | 检测项目当前阶段 |
/reverse-document | 逆向文档化现有代码 |
/gate-check | 质量门禁检查 |
/map-systems | 系统映射 |
/design-system | 设计系统 |
🚀 发布管理
| 技能 | 用途 |
|---|---|
/release-checklist | 发布检查清单 |
/launch-checklist | 上线检查清单 |
/changelog | 变更日志生成 |
/patch-notes | 补丁说明 |
/hotfix | 热修复流程 |
🎨 创意协作
| 技能 | 用途 |
|---|---|
/brainstorm | 头脑风暴 |
/playtest-report | 试玩报告 |
/prototype | 原型开发 |
/onboard | 新人入职引导 |
/localize | 本地化 |
👥 团队协调
| 技能 | 用途 |
|---|---|
/team-combat | 战斗系统团队协作 |
/team-narrative | 叙事系统团队协作 |
/team-ui | UI 系统团队协作 |
/team-release | 发布团队协作 |
/team-polish | 打磨团队协作 |
/team-audio | 音频团队协作 |
/team-level | 关卡设计团队协作 |
🪝 8 个自动化钩子
Hooks 在后台自动运行,无需手动触发:
| Hook | 触发时机 | 功能 |
|---|---|---|
validate-commit.sh | git commit | 检查硬编码值、TODO格式、JSON有效性、设计文档章节 |
validate-push.sh | git push | 警告受保护分支的push |
validate-assets.sh | 资源文件写入 | 验证命名规范和JSON结构 |
session-start.sh | 会话启动 | 加载Sprint上下文和最近git活动 |
detect-gaps.sh | 会话启动 | 检测新项目(建议 /start)和缺失文档 |
pre-compact.sh | 上下文压缩前 | 保留会话进度笔记 |
session-stop.sh | 会话关闭 | 记录完成情况 |
log-agent.sh | Agent生成 | 所有子Agent调用的审计追踪 |
📐 11 条路径规则
Coding 标准根据文件位置自动强制执行:
| 路径 | 强制规则 |
|---|---|
src/gameplay/** | 数据驱动值、delta time使用、禁止UI引用 |
src/core/** | 热路径零分配、线程安全、API稳定性 |
src/ai/** | 性能预算、可调试性、数据驱动参数 |
src/networking/** | 服务器权威、版本化消息、安全性 |
src/ui/** | 不拥有游戏状态、本地化就绪、无障碍支持 |
design/gdd/** | 必须包含8个章节、公式格式、边界情况 |
tests/** | 测试命名规范、覆盖率要求、fixture模式 |
prototypes/** | 放宽标准、需要README、需要文档化假设 |
🔄 Agent 协调机制
委托模型
- 垂直委托 — 导演 → 主管 → 专家
- 水平咨询 — 同级 Agent 可以相互咨询,但不能做跨域约束决策
- 冲突解决 — 分歧向上升级到共同父级(设计→creative-director,技术→technical-director)
- 变更传播 — 跨部门变更由
producer协调 - 域边界 — Agent 不能在其域外修改文件(除非明确授权)
协作协议
这不是自动驾驶系统!
每个 Agent 遵循严格的协作协议:
- 问 — Agent 在提出解决方案前先问问题
- 展示选项 — Agent 展示 2-4 个选项及利弊
- 你决定 — 用户始终做最终决定
- 草稿 — Agent 在定稿前先展示工作
- 批准 — 未经用户签字,什么都不会被写入
🎮 设计哲学
项目基于专业游戏开发实践:
| 理论 | 应用 |
|---|---|
| MDA Framework | Mechanics、Dynamics、Aesthetics 分析 |
| Self-Determination Theory | 玩家动机:自主性、能力感、归属感 |
| Flow State Design | 挑战-技能平衡 |
| Bartle Player Types | 受众定位和验证 |
| Verification-Driven Development | 测试优先 |
🚀 快速上手
前置要求
- Git
- Claude Code
- 推荐:jq(Hook验证用)和 Python 3(JSON验证用)
所有 Hook 在缺少可选工具时会优雅降级 — 不会报错,只是失去某些验证。
安装步骤
# 1. 克隆或作为模板使用
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
# 2. 打开 Claude Code
claude
# 3. 运行 /start — 系统会问你在哪个阶段
# (毫无头绪、模糊概念、清晰设计、现有工作)
# 然后引导你到正确的工作流
# 或者直接跳转到特定技能
/brainstorm # 从零探索游戏想法
/setup-engine godot 4.6 # 如果已确定引擎,直接配置
/project-stage-detect # 分析现有项目📁 项目结构
Claude-Code-Game-Studios/
├── CLAUDE.md # 主配置
├── .claude/
│ ├── settings.json # Hooks、权限、安全规则
│ ├── agents/ # 48 个 Agent 定义
│ ├── skills/ # 37 个斜杠命令
│ ├── hooks/ # 8 个自动化脚本
│ ├── rules/ # 11 条路径规则
│ └── docs/
│ ├── templates/ # 29 个文档模板
│ └── ...
├── src/ # 游戏源代码
├── assets/ # 美术、音频、VFX、着色器、数据文件
├── design/ # GDDs、叙事文档、关卡设计
├── docs/ # 技术文档和 ADR
├── tests/ # 测试套件
├── tools/ # 构建和流水线工具
├── prototypes/ # 临时原型(与 src/ 隔离)
└── production/ # Sprint 计划、里程碑、发布跟踪🤔 适用场景
| 场景 | 为什么适合 |
|---|---|
| 独立游戏开发 | 没有团队?让 AI 成为你的团队 |
| 游戏原型验证 | 快速迭代想法,系统化验证 |
| 游戏开发学习 | 跟着专业的工作室流程学习 |
| 个人项目升级 | 从「想到哪打到哪」到「系统性开发」 |
| AI Agent 研究 | 学习多 Agent 协作的最佳实践 |
⚠️ 局限性
| 局限 | 说明 |
|---|---|
| 非自动驾驶 | 用户必须参与每个决策 |
| 需要明确方向 | 对完全不知道做什么的新手帮助有限 |
| 上下文窗口 | 48 个 Agent 的元数据可能撑满上下文 |
| 引擎特定优化 | 主要针对 Godot/Unity/Unreal,其他引擎需要自定义 |
📌 总结
一句话定义
Claude Code Game Studios 是一个将 Claude Code 从单一助手升级为多 Agent 游戏开发工作室的模板,提供 48 个专业 Agent、37 个工作流、8 个自动化 Hook 和 11 条路径规则,让 AI 辅助开发保持专业工作室的质量标准。
核心价值
| 价值 | 具体表现 |
|---|---|
| 🎯 专业结构 | 三层 Agent 层级,职责分明 |
| ✅ 质量门禁 | 自动验证 commit、push、资源文件 |
| 📋 模板丰富 | 29 个文档模板,覆盖全流程 |
| 🔄 协作协议 | Ask → Options → You Decide → Draft → Approve |
| 🎮 引擎覆盖 | Godot、Unity、Unreal 三大引擎专属 Agent |
GitHub 链接
- 主仓库:https://github.com/Donchitos/Claude-Code-Game-Studios
- 文档:内置
/start引导 + Wiki
🦞 钳岳星君整理|2026 年 3 月 26 日
📚 延伸阅读