Claude Code 游戏工作室

将一次 Claude Code 会话转变为一个完整的游戏开发工作室。
48 个智能体。37 条工作流。一支协调一致的人工智能团队。

---

为何存在

单独使用 AI 开发游戏虽然强大，但单次聊天会话缺乏结构。没有人会阻止你硬编码魔法数字、跳过设计文档或写出混乱的代码。没有质量保证环节，没有设计评审，也没有人会问：“这真的符合游戏的愿景吗？”

Claude Code 游戏工作室 解决了这一问题，它为你的 AI 会话赋予了真实工作室的结构。与其只有一个通用助手，不如拥有 48 个专业化的智能体，按工作室层级组织起来——有守护愿景的导演、负责各自领域的部门负责人，以及执行具体工作的专家。每个智能体都有明确的职责、升级路径和质量关卡。

结果就是：你仍然掌控所有决策，但现在拥有一支能够提出正确问题、及早发现错误并从最初构思到最终发布全程保持项目有序的团队。

---

目录

• 包含内容
• 工作室层级
• 斜杠命令
• 快速入门
• 升级指南
• 项目结构
• 工作原理
• 设计哲学
• 自定义选项
• 平台支持
• 社区
• 许可证

---

包含内容

类别	数量	描述
智能体	48	涵盖设计、编程、美术、音频、叙事、QA 和制作等领域的专业化子智能体
技能	37	常用工作流的斜杠命令（/start、/sprint-plan、/code-review、/brainstorm 等）
钩子	8	针对提交、推送、资源变更、会话生命周期、智能体审计及差距检测的自动化验证
规则	11	在编辑游戏玩法、引擎、AI、UI、网络代码等领域时强制执行的路径范围编码标准
模板	29	用于 GDD、ADR、冲刺计划、经济模型、派系设计等的文档模板

工作室层级

智能体分为三个层级，与现实中的工作室运作方式一致：

第一层级 — 导演（Opus）
  创意总监    技术总监    制片人

第二层级 — 部门负责人（Sonnet）
  游戏设计师    首席程序员    美术总监
  音频总监    叙事总监    QA 负责人
  发行经理    本地化负责人

第三层级 — 专家（Sonnet/Haiku）
  游戏玩法程序员    引擎程序员    AI 程序员
  网络程序员    工具程序员    UI 程序员
  系统设计师    地图设计师    经济系统设计师
  技术美术师    音效设计师    编剧
  世界构建者    UX 设计师    原型师
  性能分析师    DevOps 工程师    分析工程师
  安全工程师    QA 测试员    无障碍专家
  运营设计师    社区经理

引擎专家

模板包含了三大主流引擎的智能体集合。请根据你的项目选择相应的集合：

引擎	首席智能体	子专家
Godot 4	godot-specialist	GDScript、着色器、GDExtension
Unity	unity-specialist	DOTS/ECS、着色器/VFX、Addressables、UI Toolkit
Unreal Engine 5	unreal-specialist	GAS、蓝图、复制、UMG/CommonUI

斜杠命令

在 Claude Code 中输入 / 即可访问全部 37 种技能：

评审与分析 /design-review /code-review /balance-check /asset-audit /scope-check /perf-profile /tech-debt

生产 /sprint-plan /milestone-review /estimate /retrospective /bug-report

项目管理 /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 /team-release /team-polish /team-audio /team-level

快速入门

先决条件

• Git
• Claude Code (npm install -g @anthropic-ai/claude-code)
• 推荐: jq（用于钩子验证）和 Python 3（用于 JSON 验证）

如果缺少可选工具，所有钩子都会优雅地失败——不会导致任何中断，只是失去验证功能。

设置步骤

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

升级指南

已经在使用此模板的旧版本？请参阅 UPGRADING.md，其中提供了逐步迁移说明、各版本之间的变更对比，以及哪些文件可以安全覆盖、哪些需要手动合并的内容。

项目结构

CLAUDE.md                           # 主配置文件
.claude/
  settings.json                     # 钩子、权限、安全规则
  agents/                           # 48个智能体定义（Markdown + YAML 前置元数据）
  skills/                           # 37个斜杠命令（每个技能一个子目录）
  hooks/                            # 8个钩子脚本（Bash，跨平台）
  rules/                            # 11条路径范围内的代码规范
  docs/
    quick-start.md                  # 详细使用指南
    agent-roster.md                 # 包含领域信息的完整智能体列表
    agent-coordination-map.md       # 委托与升级路径
    setup-requirements.md           # 先决条件及平台说明
    templates/                      # 28个文档模板
src/                                # 游戏源代码
assets/                             # 美术资源、音频、特效、着色器、数据文件
design/                             # 游戏设计文档、叙事文档、关卡设计
docs/                               # 技术文档和架构决策记录
tests/                              # 测试套件
tools/                              # 构建与流水线工具
prototypes/                         # 一次性原型（与 src/ 分离）
production/                         # 开发冲刺计划、里程碑、发布跟踪

工作原理

智能体协调

智能体遵循结构化的委托模型：

1. 垂直委托 — 导演将任务委派给主管，主管再委派给专员。
2. 水平协商 — 同级智能体可以相互咨询，但不能做出具有约束力的跨领域决策。
3. 冲突解决 — 意见分歧会逐级上报至共同上级（设计领域的“创意总监”，技术领域的“技术总监”）。
4. 变更传播 — 跨部门的变更由“制作人”统一协调。
5. 领域边界 — 智能体不得在未获明确授权的情况下修改其所属领域之外的文件。

协作而非自主

这不是一套自动驾驶系统。每个智能体都严格遵守协作协议：

1. 提问 — 智能体在提出解决方案前会先提问。
2. 呈现选项 — 智能体会展示2–4个备选方案，并列出各自的优缺点。
3. 你来决定 — 最终决策权始终在用户手中。
4. 草稿阶段 — 智能体会在最终定稿前先展示工作成果。
5. 审批确认 — 未经你的签字确认，任何内容都不会被写入。

你始终掌控全局。智能体提供的是结构化支持与专业建议，而非自主决策能力。

自动化安全机制

每次会话启动时，钩子都会自动运行：

钩子	触发条件	功能
validate-commit.sh	git commit	检查硬编码值、TODO 格式、JSON 有效性以及设计文档各部分是否齐全
validate-push.sh	git push	对推送到保护分支的操作发出警告
validate-assets.sh	写入 assets/ 目录	验证命名规范和 JSON 结构
session-start.sh	会话开始	加载当前冲刺上下文及最近的 Git 活动
detect-gaps.sh	会话开始	检测新项目（建议使用 /start 命令）以及存在代码或原型却缺少文档的情况
pre-compact.sh	上下文压缩	保存会话进度笔记
session-stop.sh	会话结束	记录已完成的工作
log-agent.sh	智能体启动	记录所有子智能体调用的日志

权限规则位于 settings.json 中，会自动允许安全操作（如查看 Git 状态、运行测试），并阻止危险操作（如强制推送、rm -rf、读取 .env 文件）。

路径范围规则

代码规范会根据文件位置自动执行：

路径	强制执行的内容
src/gameplay/**	数据驱动的数值、时间增量的使用、禁止引用 UI
src/core/**	热点路径中零内存分配、线程安全性、API 稳定性
src/ai/**	性能预算、可调试性、参数数据驱动
src/networking/**	服务器权威性、消息版本控制、安全性
src/ui/**	不得持有游戏状态、支持本地化、符合无障碍标准
design/gdd/**	必须包含 8 个章节、公式格式、边缘情况处理
tests/**	测试命名规范、覆盖率要求、测试夹具模式
prototypes/**	规范较为宽松，需包含 README，并记录假设

设计理念

该模板基于专业的游戏开发实践：

• MDA 框架 — 通过机制、动态和美学分析进行游戏设计。
• 自我决定理论 — 从自主性、胜任感和关联感出发，激发玩家动机。
• 心流状态设计 — 通过挑战与技能的平衡提升玩家参与度。
• 巴特尔玩家类型 — 针对不同受众群体进行定位与验证。
• 验证驱动开发 — 先编写测试，再进行实现。

自定义选项

这是一个模板，而非锁定的框架。所有内容均可根据需求进行自定义：

• 增删智能体 — 删除不需要的智能体文件，添加适用于你项目的智能体。
• 编辑智能体提示词 — 调整智能体行为，加入项目特定知识。
• 修改技能 — 根据团队流程调整工作流。
• 新增规则 — 为项目目录结构创建新的路径范围规则。
• 调整钩子 — 改变验证严格程度，或添加新的检查项。
• 选择引擎 — 使用 Godot、Unity 或 Unreal 的智能体集合（也可不使用）。

平台支持

已在 Windows 10 上使用 Git Bash 进行测试。所有钩子均采用 POSIX 兼容的模式（如 grep -E，而非 grep -P），并提供了缺失工具的回退方案。无需修改即可在 macOS 和 Linux 上运行。

社区

• 讨论区 — GitHub Discussions 用于提问、分享想法以及展示你的成果。
• 问题追踪 — Bug 报告与功能请求

---

本项目仍在积极开发中。目前的智能体架构、技能和协调系统已经非常成熟且可用，未来还将持续优化与扩展。

许可证

MIT 许可证。详情请参阅 LICENSE 文件。

Claude-Code-Game-Studios 快速上手指南

将单个 Claude Code 会话转变为完整的游戏开发工作室。本工具提供 48 个专用智能体（Agents）、37 个工作流技能和自动化质量检查，帮助你在 AI 辅助下构建结构清晰、高质量的游戏项目。

环境准备

在开始之前，请确保你的系统满足以下要求：

系统要求

• 操作系统：Windows 10 (推荐使用 Git Bash)、macOS 或 Linux
• 核心依赖：
  • Git
  • Claude Code
  • Node.js (用于安装 Claude Code)

可选依赖（推荐安装）

以下工具用于增强自动化验证功能，若未安装，相关钩子（Hooks）会自动跳过而不影响核心功能：

• jq：用于 JSON 数据验证
• Python 3：用于额外的脚本验证

安装核心依赖

使用 npm 全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

提示：国内用户若遇到 npm 下载缓慢，可临时切换至淘宝镜像源：

npm config set registry https://registry.npmmirror.com

安装步骤

1. 克隆项目

将模板克隆到本地作为你的游戏项目根目录：

git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game

2. 启动会话

在项目目录下启动 Claude Code：

claude

3. 初始化配置

进入会话后，系统会自动加载 48 个智能体和 37 个技能。无需手动配置即可直接使用。

基本使用

本工具的核心是通过 Slash Commands (/) 调用预定义的工作流。你始终拥有决策权，智能体负责提供专业建议和执行具体任务。

场景一：从零开始新项目

如果你只有一个模糊的想法，不知道如何开始，运行：

/start

系统会引导你选择当前状态（无想法、概念模糊、设计清晰或已有代码），并自动匹配最合适的工作流。

场景二：头脑风暴与创意构思

想要探索新的游戏机制或故事背景：

/brainstorm

智能体将基于 MDA 框架和自我决定理论为你提供多个创意选项及优缺点分析。

场景三：配置游戏引擎

如果你已确定使用的引擎，可直接配置对应的专家智能体：

/setup-engine godot 4.6

支持 godot、unity 和 unreal 三种引擎，会自动加载对应的专属智能体（如 godot-specialist）和技术规范。

场景四：代码审查与设计评审

在提交代码或推进设计前，进行质量检查：

/code-review
/design-review

智能体会检查硬编码数值、架构合理性及是否符合设计文档愿景。

场景五：团队协作模式

针对复杂功能，协调多个领域的智能体共同工作：

/team-combat   # 协调战斗系统相关的程序、设计和音效智能体
/team-ui       # 协调 UI 相关的程序和美术智能体

自动化保护

项目内置了 8 个自动化钩子（Hooks），在你执行 git commit、git push 或修改资源文件时自动运行，防止硬编码、格式错误或缺失文档等问题，确保项目始终符合专业开发标准。