Donchitos/Claude-Code-Game-Studios · 上手攻略
- 仓库：Donchitos/Claude-Code-Game-Studios
- 链接：https://github.com/Donchitos/Claude-Code-Game-Studios
- 分类：agent · trending
- 作者：Tom
- 更新：2026-07-08
这是什么
Claude-Code-Game-Studios 是一个开源的 Claude Code 增强模板，旨在将"单人会话 AI 辅助"升级为"结构完整的游戏开发工作室"。
它通过预配置的 49 个专业 Agent、73 个 Slash Commands、12 个自动化 Hooks 和 11 套路径作用域代码规范，让 Claude Code 在游戏开发场景下拥有真实工作室的层级协作体系：创意总监把关方向、技术总监审核架构、各领域专家（程序/美术/音频/策划/QA）各司其职。
⚠️ 这是一个模板/配置集，不是独立应用。需要配合 Claude Code 使用（npm 安装）。
解决什么问题
| 痛点 | Claude-Code-Game-Studios 如何解决 |
|---|---|
| 单会话 AI 没有架构 | 49 个 Agent 分层协作，方向/领域/专项分离 |
| AI 容易硬编码 magic numbers | Hook 强制校验提交前的代码规范 |
| 没有设计文档流程 | 41 个文档模板（GDD、UX spec、ADR 等） |
| QA 和设计审查缺失 | /code-review /design-review /balance-check 等专项技能 |
| 多人协作时 AI 行为混乱 | 11 套路径作用域规则，不同目录自动应用不同标准 |
| 游戏引擎不匹配 | 内置 Godot / Unity / Unreal 三套 Agent 集合，按需选用 |
快速安装
前提条件
- Git：https://git-scm.com/
- Claude Code：需先安装
@anthropic-ai/claude-codebash npm install -g @anthropic-ai/claude-code - 可选：
jq（Hook 校验用）和 Python 3（JSON 校验用）。缺少这些工具时 Hook 会优雅降级，不影响核心功能。
安装模板
# 方式一：克隆为新项目
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
# 方式二：作为 GitHub Template 使用
# 在 GitHub 仓库页面点击 "Use this template"
安装后，项目根目录包含 CLAUDE.md（主配置）和 .claude/ 子目录（agents/skills/hooks/rules）。
启动
claude
# 进入 Claude Code 会话
核心用法
/start 引导流程
第一次进入项目后，运行：
/start
系统会询问你当前所处阶段（毫无头绪 → 模糊概念 → 清晰设计 → 已有代码），并引导到对应的工作流。无需预设任何知识。
/setup-engine 配置引擎
已有明确技术选型时，直接指定引擎：
/setup-engine godot 4.6
/setup-engine unity
/setup-engine unreal 5
这会激活对应引擎的专业 Agent 集合。
/project-stage-detect 分析已有项目
项目已有代码但无文档时，运行此技能，AI 会分析现有代码结构并建议补全哪些设计文档。
工作室层级架构
Agent 分为三级，对应真实工作室结构：
Tier 1 — 导演（Opus 模型）
| Agent | 职责 |
|---|---|
| creative-director | 创意方向、玩法愿景、品牌一致性 |
| technical-director | 技术架构、代码质量、技术债务 |
| producer | 进度、跨部门协调、变更传播 |
Tier 2 — 部门主管（Sonnet 模型）
| Agent | 职责 |
|---|---|
| game-designer | 玩法设计、系统设计、平衡性 |
| lead-programmer | 代码架构、技术决策 |
| art-director | 美术规范、资产管线 |
| audio-director | 音频设计 |
| narrative-director | 叙事、对话、故事 |
| qa-lead | 测试计划、缺陷管理 |
| release-manager | 发布流程、打包 |
| localization-lead | 本地化 |
Tier 3 — 专家（Haiku/Sonnet）
涵盖 gameplay-programmer、ui-programmer、level-designer、ux-designer、qa-tester、devops-engineer、security-engineer、accessibility-specialist 等 30+ 角色。
关键 Slash Commands 分类
设计阶段
| 命令 | 作用 |
|---|---|
/brainstorm |
从零探索游戏创意 |
/design-system |
建立设计语言和规范 |
/map-systems |
玩法系统拆解与映射 |
/create-epics |
创建史诗（Epic）工作项 |
/create-stories |
从 Epic 拆解用户故事 |
开发阶段
| 命令 | 作用 |
|---|---|
/dev-story |
开发一个完整用户故事 |
/story-done |
标记故事完成并做验收检查 |
/code-review |
代码审查 |
/architecture-decision |
记录技术决策（ADR） |
QA 与测试
| 命令 | 作用 |
|---|---|
/qa-plan |
制定测试计划 |
/smoke-check |
冒烟测试 |
/balance-check |
数值平衡检查 |
/test-setup |
搭建测试框架 |
发布与运营
| 命令 | 作用 |
|---|---|
/release-checklist |
发布前核查清单 |
/changelog |
自动生成更新日志 |
/playtest-report |
试玩报告 |
Hooks（自动化门卫）
12 个 Hook 在背后自动运行：
| Hook | 触发 | 功能 |
|---|---|---|
validate-commit.sh |
每次 Bash 工具调用 | 检查 magic numbers、TODO 格式、JSON 有效性 |
validate-push.sh |
push 时 | 警告受保护分支推送 |
validate-assets.sh |
资源文件写入后 | 校验命名规范和 JSON 结构 |
session-start.sh |
会话开启 | 显示当前分支和最近提交 |
detect-gaps.sh |
会话开启 | 检测缺失设计文档 |
log-agent.sh/stop.sh |
Agent 启动/停止 | 审计轨迹记录 |
⚠️ Hook 在无关命令/文件时会立即 exit 0 退出，非性能问题，是正常行为。
代码规范（Rules）
不同路径自动应用不同标准：
| 路径 | 强制规范 |
|---|---|
src/gameplay/** |
数据驱动值、delta time、无 UI 引用 |
src/core/** |
热路径零分配、线程安全 |
src/ai/** |
性能预算、可调试性 |
src/networking/** |
服务器权威、版本化消息 |
src/ui/** |
无游戏状态持有、本地化就绪 |
design/gdd/** |
8 个必要章节、公式格式 |
典型适用场景
- 独立游戏全流程开发：从概念到发布，AI 覆盖设计→开发→测试→发布的完整链条
- 原型快速验证：用
/prototype快速搭游戏核心循环 - 游戏 JAM 参赛：模板提供完整工作流，适合时间受限的场景
- 已有项目规范化：接入现有游戏项目，补全文档和测试体系
- 学习游戏开发：通过工作室协作流程理解专业游戏团队如何运作
坑与注意
| 坑 | 说明 |
|---|---|
| Claude Code 必需 | 没有 Claude Code 这个 npm 包则完全无法使用 |
首次 /start 耗时 |
Opus 模型调用成本高，首次引导可能较慢 |
| Windows 兼容性 | 核心 hooks 已做 POSIX 兼容，但 notify.sh 仅支持 Windows PowerShell，macOS/Linux 桌面通知未实装 |
| 受限于 Claude Code 上下文窗口 | 超大游戏项目可能需要频繁压缩（compact）上下文 |
| 不适合非游戏项目 | 这是专用模板，拿来做 Web App 会感觉框架过重 |
| 模型组合成本 | Tier 1 用 Opus 成本高，Sonnet 次之，可按需降低 Tier 3 模型规格 |
与同类对比
| 项目 | 定位 | 优势 | 劣势 |
|---|---|---|---|
| Claude-Code-Game-Studios | 游戏开发专用模板 | 49 Agent 协作、覆盖完整工作室流程 | 强依赖 Claude Code，非通用 |
| Cursor / Copilot | 通用 AI 编程 | 普适性强 | 无专用工作流，游戏方向薄弱 |
| game-ability/Claude-MCP-Godot | Godot 专用 Agent | Godot 集成深 | 生态较窄 |
| LangChain Game Dev | 游戏 AI 框架 | 可扩展 | 学习曲线陡 |
一句话结论
如果你已经在用 Claude Code 并想认真做游戏开发，装上这个模板相当于给你的 AI 编程环境配备了一整套 AAA 工作室的协作流程——从创意总监到 QA 都能随叫随到。
来源
- GitHub README：https://github.com/Donchitos/Claude-Code-Game-Studios
- 官方升级指南：仓库内
UPGRADING.md - Claude Code 官方文档：https://docs.anthropic.com/en/docs/claude-code