将一个 Claude Code 会话变成一个完整的游戏开发工作室。
48 个代理。37 个工作流。一支协同的 AI 团队。

用 AI 独立开发游戏非常强大——但一个聊天会话缺乏结构。没有人阻止你硬编码魔法数字、跳过设计文档、或者写出面条代码。没有 QA 审查、没有设计评审、没有人问"这真的符合游戏愿景吗？"

Claude Code Game Studios 通过给你的 AI 会话赋予真实工作室的结构来解决这个问题。你得到的不是一个通用助手，而是 48 个按工作室层级组织的专业代理——总监守护愿景，部门负责人掌控各自领域，专家负责具体执行。每个代理都有明确的职责、上报路径和质量关卡。

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

• 包含内容
• 工作室层级
• 斜杠命令
• 快速开始
• 升级
• 项目结构
• 工作原理
• 设计理念
• 自定义
• 平台支持
• 社区
• 许可证

代理分为三个层级，与真实工作室的运作方式一致：

第一层级 — 总监 (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

模板包含三大引擎的代理集。使用与你项目匹配的代理集：

在 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 frontmatter）
  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/                             # 美术、音频、VFX、着色器、数据文件
design/                             # GDD、叙事文档、关卡设计
docs/                               # 技术文档和 ADR
tests/                              # 测试套件
tools/                              # 构建和流水线工具
prototypes/                         # 一次性原型（与 src/ 隔离）
production/                         # 冲刺计划、里程碑、发布跟踪

代理遵循结构化的委派模型：

1. 垂直委派 ——总监委派给部门负责人，部门负责人委派给专家
2. 横向协商 ——同层级代理可以相互协商，但不能做出跨领域的约束性决策
3. 冲突解决 ——分歧上报至共同的上级（设计冲突上报至 creative-director，技术冲突上报至 technical-director）
4. 变更传播 ——跨部门的变更由 producer 协调
5. 领域边界 ——代理不修改其领域之外的文件，除非有明确委派

这不是一个自动驾驶系统。每个代理遵循严格的协作协议：

1. 提问 ——代理在提出解决方案之前先提问
2. 展示选项 ——代理展示 2-4 个方案及其利弊
3. 你做决定 ——用户始终做出最终决定
4. 草稿 ——代理在最终确认前展示工作成果
5. 审批 ——没有你的确认，不会写入任何内容

你始终掌控全局。代理提供结构和专业知识，而不是自主行动。

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

settings.json 中的权限规则自动允许安全操作（git status、测试运行），阻止危险操作（强制推送、rm -rf、读取 .env 文件）。

编码标准根据文件位置自动强制执行：

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

• MDA 框架 ——机制、动态、美学分析用于游戏设计
• 自我决定理论 ——自主性、能力感、关联性用于玩家动机
• 心流状态设计 ——挑战与技能的平衡用于玩家参与度
• 巴特尔玩家类型 ——目标受众定位与验证
• 验证驱动开发 ——先写测试，再实现功能

这是一个模板，不是锁定的框架。一切都可以自定义：

• 添加/删除代理 ——删除不需要的代理文件，为你的领域添加新代理
• 编辑代理提示词 ——调整代理行为，添加项目特定知识
• 修改技能 ——调整工作流以匹配你的团队流程
• 添加规则 ——为你的项目目录结构创建新的路径范围规则
• 调整钩子 ——调整验证严格程度，添加新检查
• 选择引擎 ——使用 Godot、Unity 或 Unreal 代理集（或都不用）

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

• 讨论区 —— GitHub Discussions 用于提问、分享想法和展示你的作品
• 问题反馈 —— Bug 报告和功能请求

本项目正在积极开发中。代理架构、技能和协调系统已经成熟可用——但还有更多功能即将推出。

MIT 许可证。详见 LICENSE。