目录

Claude Code Game Studios:让 Claude Code 变成完整游戏开发工作室

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 4godot-specialistGDScript、Shaders、GDExtension
Unityunity-specialistDOTS/ECS、Shaders/VFX、Addressables、UI Toolkit
Unreal Engine 5unreal-specialistGAS、Blueprints、Replication、UMG/CommonUI

⚡ 37 个工作流技能

通过 / 斜杠命令访问所有技能,分为六大类:

📋 评审与分析

技能用途
/design-review设计评审
/code-review代码评审
/balance-check游戏平衡性检查
/asset-audit资源审计
/scope-check范围检查
/perf-profile性能分析
/tech-debt技术债务分析

🏭 生产管理

技能用途
/sprint-planSprint 规划
/milestone-review里程碑评审
/estimate工作量估算
/retrospective回顾会议
/bug-reportBug 报告

📁 项目管理

技能用途
/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-uiUI 系统团队协作
/team-release发布团队协作
/team-polish打磨团队协作
/team-audio音频团队协作
/team-level关卡设计团队协作

🪝 8 个自动化钩子

Hooks 在后台自动运行,无需手动触发:

Hook触发时机功能
validate-commit.shgit commit检查硬编码值、TODO格式、JSON有效性、设计文档章节
validate-push.shgit push警告受保护分支的push
validate-assets.sh资源文件写入验证命名规范和JSON结构
session-start.sh会话启动加载Sprint上下文和最近git活动
detect-gaps.sh会话启动检测新项目(建议 /start)和缺失文档
pre-compact.sh上下文压缩前保留会话进度笔记
session-stop.sh会话关闭记录完成情况
log-agent.shAgent生成所有子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 协调机制

委托模型

  1. 垂直委托 — 导演 → 主管 → 专家
  2. 水平咨询 — 同级 Agent 可以相互咨询,但不能做跨域约束决策
  3. 冲突解决 — 分歧向上升级到共同父级(设计→creative-director,技术→technical-director)
  4. 变更传播 — 跨部门变更由 producer 协调
  5. 域边界 — Agent 不能在其域外修改文件(除非明确授权)

协作协议

这不是自动驾驶系统!

每个 Agent 遵循严格的协作协议:

  1. — Agent 在提出解决方案前先问问题
  2. 展示选项 — Agent 展示 2-4 个选项及利弊
  3. 你决定 — 用户始终做最终决定
  4. 草稿 — Agent 在定稿前先展示工作
  5. 批准 — 未经用户签字,什么都不会被写入

🎮 设计哲学

项目基于专业游戏开发实践:

理论应用
MDA FrameworkMechanics、Dynamics、Aesthetics 分析
Self-Determination Theory玩家动机:自主性、能力感、归属感
Flow State Design挑战-技能平衡
Bartle Player Types受众定位和验证
Verification-Driven Development测试优先

🚀 快速上手

前置要求

所有 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 日


📚 延伸阅读