49个AI智能体组建游戏工作室：Claude Code Game Studios 深度解析

前言

在 AI 能力飞速发展的今天，我们不再满足于让大模型只充当对话助手。于是涌现出许多提效工具，比如本文的主角：Claude Code Game Studios——一个完全由 Claude 模型驱动的虚拟游戏工作室，目前已在 GitHub 收获 2 万多 Star。

在这个工具中，Opus、Sonnet 与 Haiku 分别扮演总监、部门负责人与一线专家，通过清晰的层级协作与角色分工，模拟真实游戏开发的完整流程。这不仅是对 AI 组织能力的实验，更是对 AI 原生团队 如何高效创造的前瞻性探索。

一、Claude Code Game Studios 使用指南

1.1 项目概述

将单个 Claude Code 会话转变为完整的游戏开发工作室：49 个专业代理 · 72 个技能命令 · 一支协调的 AI 团队。

Claude Code Game Studios 是一个为 Claude Code 设计的游戏开发工作室模板。它将单个 AI 助手转变为一个结构化的游戏开发团队，包含：

1.2 为什么需要这个项目

问题：使用 AI 独立开发游戏很强大，但单个聊天会话没有结构。没人阻止你硬编码魔法数字、跳过设计文档、或编写面条代码。没有 QA 检查、没有设计评审、没人问“这真的符合游戏愿景吗？”

解决方案：Claude Code Game Studios 为你的 AI 会话提供真实工作室的结构。你将获得 49 个按工作室层级组织的专业代理——守护愿景的总监、拥有自己领域的部门负责人、以及做具体工作的专家。每个代理都有明确的职责、升级路径和质量门控。

结果：你仍然做出每个决定，但现在有一个团队提出正确的问题、及早发现错误、并从第一次头脑风暴到发布都保持项目有序。

1.3 使用说明及下载

• GitHub 下载地址：https://github.com/Donchitos/Claude-Code-Game-Studios
• CSDN 下载地址：Claude Code Game Studios
• 白嫖地址：公众号搜呆呆敲代码的小Y，回复【素材资源】

温馨提示：虽然这个工具很强，但建议刚开始使用时选择一些超轻量的小游戏练练手，搞明白整个工作流之后再正式构思自己的游戏创意，这一点很关键！

二、核心功能

2.1 结构化代理系统

代理按三个层级组织，模拟真实工作室的运作方式：

第一层 — 总监 (Opus 模型)

creative-director    technical-director    producer

第二层 — 部门负责人 (Sonnet 模型)

game-designer        lead-programmer       art-director
audio-director       narrative-director    qa-lead
release-manager      localization-lead

第三层 — 专家 (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    community-manager

2.2 引擎专家系统

模板包含三大主流引擎的代理集合。选择匹配你项目的集合：

2.3 协作协议

这是协作系统，不是自动执行系统。每个代理遵循严格的协作协议：

• 询问 — 代理在提出解决方案前先提问
• 展示选项 — 代理展示 2-4 个选项及优缺点
• 你决定 — 用户总是做出决定
• 起草 — 代理在最终确定前展示工作
• 批准 — 没有你的批准，什么都不写入

你保持控制权。代理提供结构和专业知识，而不是自主权。

2.4 自动化安全

钩子在每次会话自动运行：

三、快速开始

3.1 前置要求

• Git
• Claude Code (npm install -g @anthropic-ai/claude-code)

所有钩子在没有可选工具时会失败 — 不会破坏任何东西，只是失去验证功能。

3.2 安装步骤

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 — 分析现有项目

四、工作室层级架构

1. 第一层 — 领导代理 (Opus)

2. 第二层 — 部门负责人代理 (Sonnet)

3. 第三层 — 专家代理 (Sonnet 或 Haiku)

五、Skill 技能命令系统

在 Claude Code 中输入 / 访问所有 72 个技能：

1. 入门与导航

2. 游戏设计

3. UX 与界面设计

4. 架构

5. 故事与冲刺

6. 审查与分析

7. QA 与测试

8. 制作

9. 发布

10. 创意与内容

11. 团队编排

协调多个代理在单个功能区域：

六、自动化钩子

钩子在 .claude/settings.json 中配置并自动触发：

• validate-commit.sh — 提交验证

  • 触发：git commit 命令
  • 检查：设计文档必需章节、JSON 数据文件有效性、硬编码值检测、TODO 格式验证
  • 退出策略：如果命令不是 git commit 则提前退出

• validate-push.sh — 推送验证

  • 触发：git push 命令
  • 检查：推送到受保护分支（develop/main）时警告
  • 退出策略：如果命令不是 git push 则提前退出

• validate-assets.sh — 资源验证

  • 触发：资源文件写入/编辑
  • 检查：命名约定、JSON 有效性
  • 路径：仅检查 assets/ 目录中的文件

• session-start.sh — 会话开始

  • 触发：会话开始
  • 功能：加载冲刺上下文、显示里程碑、显示 git 活动、检测并预览活动会话状态文件以恢复

• detect-gaps.sh — 差距检测

  • 触发：会话开始
  • 功能：检测新项目（建议 /start）、检测缺失文档（建议 /reverse-document 或 /project-stage-detect）

• pre-compact.sh — 压缩前

  • 触发：上下文压缩前
  • 功能：将会话状态（active.md、修改的文件、WIP 设计文档）转储到对话中以便在总结后保留

• post-compact.sh — 压缩后

  • 触发：上下文压缩后
  • 功能：提醒 Claude 从 active.md 检查点恢复会话状态

• notify.sh — 通知

  • 触发：通知事件
  • 功能：通过 PowerShell 显示 Windows toast 通知

• session-stop.sh — 会话停止

  • 触发：会话结束
  • 功能：总结成就、更新会话日志

• log-agent.sh — 代理日志开始

  • 触发：代理启动
  • 功能：审计跟踪开始 — 记录子代理调用及时间戳

• log-agent-stop.sh — 代理日志结束

  • 触发：代理停止
  • 功能：审计跟踪结束 — 完成子代理记录

• validate-skill-change.sh — 技能变更验证

  • 触发：技能文件写入/编辑
  • 功能：修改 .claude/skills/ 后建议运行 /skill-test

七、路径规则系统

.claude/rules/ 中的规则在编辑匹配路径的文件时自动执行：

7.1 gameplay-code.md — 游戏玩法代码规则

# Gameplay Code Rules

## Data-Driven Values
- All gameplay values must be externalized to config files
- No hardcoded magic numbers in gameplay code
- Use dependency injection for config access

## Delta Time
- All time-dependent operations must use delta time
- Never assume fixed frame rate

## Separation of Concerns
- Gameplay code must not directly reference UI components
- Use events/signals for gameplay → UI communication

7.2 design-docs.md — 设计文档规则

# Design Document Rules

## Required Sections
Every GDD must include these 8 sections:
1. Overview — one-paragraph summary
2. Player Fantasy — intended feeling and experience
3. Detailed Rules — unambiguous mechanics
4. Formulas — all math defined with variables
5. Edge Cases — unusual situations handled
6. Dependencies — other systems listed
7. Tuning Knobs — configurable values identified
8. Acceptance Criteria — testable success conditions

## Formula Format
- All formulas must use named variables
- Provide example calculations
- Document units and ranges

八、工作流程（重要）

项目遵循 7 阶段开发管道：

阶段 1：概念 (Concept)

目标：将游戏想法发展为文档化的概念

步骤：

• /brainstorm — 使用 MDA、动词优先和玩家心理学框架探索游戏概念
• /setup-engine — 配置引擎、固定版本、设置命名约定和性能预算
• 游戏概念文档 — 用支柱、MDA 分析和范围层级形式化概念
• /design-review — 验证游戏概念（推荐在继续之前）
• /art-bible — 编写视觉身份规格（9 章节）
• /map-systems — 将概念分解为具有依赖排序和优先级层次的系统

产出：

• design/gdd/game-concept.md
• design/art/art-bible.md
• design/gdd/systems-index.md

阶段 2：系统设计 (Systems Design)

目标：为系统索引中的每个系统编写 GDD

步骤：

• /design-system — 编写每个系统的 GDD（引导式、逐章节）- 每个系统运行一次
• /design-review — 验证每个 GDD（8 必需章节、无 MAJOR REVISION 裁决）- 每个系统运行
• /review-all-gdds — 跨越所有 GDD 的整体一致性检查 + 设计理论审查
• /consistency-check — 扫描所有 GDD 以发现矛盾、未定义引用和机制冲突

产出：

• design/gdd/[system-name].md (每个系统一个)
• design/gdd/gdd-cross-review-*.md

阶段 3：技术设置 (Technical Setup)

目标：架构决策、视觉身份规格、无障碍基础、引擎验证

步骤：

• /create-architecture — 编写覆盖所有系统的主架构文档
• /architecture-decision — 将关键技术决策记录为 ADR（最少 3 个基础层 ADR）
• /architecture-review — 验证完整性、依赖排序、引擎兼容性
• /create-control-manifest — 从所有接受的 ADR 生成扁平程序员规则表
• 无障碍要求文档 — 提交无障碍层级和功能矩阵

产出：

• docs/architecture/architecture.md
• docs/architecture/adr-*.md
• docs/architecture/control-manifest.md
• design/accessibility-requirements.md

阶段 4：预制作 (Pre-Production)

目标：UX 规格、资源规格、核心机制原型、定义故事、验证乐趣

步骤：

• /asset-spec — 从批准的 GDD 和关卡文档生成每个资源的视觉规格
• /ux-design — 为主菜单、核心游戏玩法 HUD 和交互模式编写 UX 规格
• /ux-review — 验证所有关键屏幕 UX 规格的 GDD 对齐和无障碍层级合规
• /prototype — 在隔离工作树中构建一次性原型以验证核心机制
• /create-epics — 将 GDD + ADR 转换为史诗 — 每个架构模块一个
• /create-stories — 将每个史诗分解为可实现的故事文件
• /test-setup — 在第一次冲刺前搭建测试框架和 CI 管道一次
• /sprint-plan — 用史诗中优先排序的故事计划第一次冲刺
• /playtest-report — 文档化垂直切片试玩会话（继续前至少 1 次会话）

产出：

• design/assets/asset-manifest.md
• design/ux/ux-spec.md
• prototypes/ 中的原型
• 故事文件
• 冲刺计划

（原文截断，后续阶段未完整展示）