跳到主要内容
Claude Code Game Studios · prolist
查看仓库原始简介 Turn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.
项目解读 README
项目解读由 AI 根据历史资料整理，尚未经人工复核。仓库资料更新于 2026-09-08，与历史解读分开保留。
项目概览 Claude Code Game Studios（CCGS）是一个开源模板仓库，将单个 Claude Code 会话改造为一个完整的游戏开发工作室。它不是一个独立工具或引擎，而是一套运行在 Anthropic Claude Code CLI 环境之上的组织架构层，通过 49 个专业 AI Agent、72 个 Slash Command（Skill）、12 个自动化 Hook、11 条路径作用域规则和 39 个文档模板，模拟真实游戏工作室的层级分工与协作流程。CCGS 属于 AI 多 Agent 协作模板，不提供新的 AI 能力，而是把 Claude Code 已有的 Agent 机制组织成一套游戏开发专用的流程体系。其核心是三级 Agent 层级，对应真实工作室的组织架构，并采用用户驱动的五步协作协议。CCGS 支持 Godot 4、Unity、Unreal Engine 5 引擎，主要测试平台为 Windows 10 + Git Bash，兼容 macOS 和 Linux。
解决什么问题 CCGS 旨在解决单人使用 AI 开发游戏时单个 Chat 会话没有结构的问题。报告指出，在没有 CCGS 之前，使用 Claude/Cursor/Copilot 等工具开发游戏面临五大结构性缺陷：一是无角色分工，一个 AI 会话同时扮演设计师、程序员、美术指导、音效师、测试员，没有领域边界，AI 容易越权做不属于它的决策，或者遗漏它应该负责的检查点；二是无质量门控，AI 生成的代码没有自动审查机制，硬编码数值、缺少设计文档、不写测试等问题在生成时不会被拦截，而是在后续迭代中逐渐积累成技术债务；三是无变更传播，游戏开发高度耦合，改了一个系统参数可能影响平衡性、UI 显示、关卡难度、叙事逻辑，单会话模式下 AI 不会主动追踪这些跨部门影响；四是无流程纪律，没有 Sprint 规划、没有 Story 拆分、没有里程碑跟踪，项目容易陷入想到哪做到哪的状态；五是无协作协议，AI 直接执行而不先问问题，用户想要的是选项列表和讨论机会。报告还对比了传统 AI 工具链的局限，包括直接用 Claude Chat 无项目级上下文、Cursor + .cursorrules 有规则但无 Agent 分工、手动管理多个 AI 会话上下文不共享、MCP Server 定制需要编程能力且不提供预制游戏开发流程。CCGS 出现的本质需求是让 AI 辅助游戏开发从聊天式升级为工作室式。
工作方式 CCGS 的核心是三级 Agent 层级，对应真实工作室的组织架构。Tier 1 为 3 个 Director（创意总监、技术总监、制作人），使用 Opus 模型，负责高层决策和愿景把控；Tier 2 为 8 个 Department Leads（游戏设计师、主程序员、美术总监、音频总监、叙事总监、QA 主管、发布经理、本地化主管），使用 Sonnet 模型，负责领域管理；Tier 3 为 22 个以上 Specialists（玩法程序员、引擎程序员、AI 程序员、网络程序员、工具程序员、UI 程序员、系统设计师、关卡设计师、经济设计师、技术美术、音效设计师、作家、世界构建师、UX 设计师、原型师、性能分析师、DevOps 工程师、分析工程师、安全工程师、QA 测试员、无障碍专家、Live-Ops 设计师、社区经理），使用 Sonnet 或 Haiku，执行具体任务。五大核心机制包括：Agent 定义（每个 Agent 是 Markdown 文件，含 YAML frontmatter 和 prompt 内容，放置在 .claude/agents/ 目录）；Skill（72 个 Slash Command 定义在 .claude/skills/ 目录，每个 Skill 是子目录含 SKILL.md）；Hook（12 个 Hook 脚本在特定事件时自动执行，如提交前检查硬编码、推送前保护分支等）；Rule（11 条路径作用域规则，根据文件路径自动激活对应编码标准）；Template（39 个文档模板覆盖 GDD、UX 规格、ADR、Sprint 计划等）。所有 Agent 严格执行五步协作协议：Ask（先问问题）、Present Options（给出 2-4 个选项及优缺点）、You Decide（用户做决策）、Draft（Agent 展示草稿）、Approve（用户批准后才写入）。
核心能力
个专业 AI Agent 组成三层架构
个 Slash Command 覆盖全流程
个自动化 Hook 守卫质量
条路径作用域规则自动激活编码标准
个文档模板确保输出一致性
用户驱动的五步协作协议
支持 Godot 4、Unity、Unreal Engine 5
提供 9 个 /team-* 命令协调多 Agent 协同
完整的上下文管理机制
审查强度可配置（full/lean/solo）
所有 Hook 在缺失可选工具时优雅降级
跨平台兼容（Windows 10 + Git Bash 主要测试，macOS、Linux 兼容）
使用前需要了解
AI 整理 · 本地测试，未经人工复核；依据历史报告节选，不代表当前产品状态。
简体中文 · AI 译文 原文
AI 中文译文，非官方翻译；安装命令与技术细节请对照原文。
报告指出 CCGS 适合独立游戏开发者用 AI 辅助全流程、需要结构化流程管理的游戏项目、希望学习游戏开发流程规范、以及 Godot/Unity/Unreal 引擎项目。不适合非游戏类软件开发、只需要快速原型验证、团队已有完善的管理工具链、以及自研引擎且不打算适配 Agent 的场景。CCGS 是模板不是框架，所有内容都可以自定义，包括添加或删除 Agent、修改 Agent 行为、新增 Skill、新增 Rule、调整 Hook、新增模板。前置条件包括 Git（必须）、Claude Code CLI（必须）、jq（推荐，缺失时优雅降级）、Python 3（推荐，缺失时优雅降级）、对应引擎（按需）。报告未说明的具体限制包括：未说明对非 Windows 平台的详细测试情况，仅提及主要测试平台为 Windows 10 + Git Bash，兼容平台为 macOS、Linux（无需修改）；未说明在大型团队或超大规模项目中的实际表现；未说明与所有 Claude Code 版本的兼容性细节；未说明性能开销的具体数据。
包含内容
工作室层级 Tier 1 — Directors (Opus)
creative-director technical-director producer
Tier 2 — Department Leads (Sonnet)
game-designer lead-programmer art-director
audio-director narrative-director qa-lead
release-manager localization-lead
Tier 3 — Specialists (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 中输入 / 以访问全部 73 项技能：
入门与导航
/start /help /project-stage-detect /setup-engine /adopt
游戏设计
/brainstorm /map-systems /design-system /quick-design /review-all-gdds /propagate-design-change
美术与资源
/art-bible /asset-spec /asset-audit
UX 与界面设计
/ux-design /ux-review
架构
/create-architecture /architecture-decision /architecture-review /create-control-manifest
故事与冲刺
/create-epics /create-stories /dev-story /sprint-plan /sprint-status /story-readiness /story-done /estimate
评审与分析
/design-review /code-review /balance-check /content-audit /scope-check /perf-profile /tech-debt /gate-check /consistency-check /security-audit
QA 与测试
/qa-plan /smoke-check /soak-test /regression-suite /test-setup /test-helpers /test-evidence-review /test-flakiness /skill-test /skill-improve
制作
/milestone-review /retrospective /bug-report /bug-triage /reverse-document /playtest-report
发布
/release-checklist /launch-checklist /changelog /patch-notes /hotfix /day-one-patch
创意与内容
/prototype /onboard /localize
团队编排 （在单个功能上协调多个代理）
/team-combat /team-narrative /team-ui /team-release /team-polish /team-audio /team-level /team-live-ops /team-qa
快速开始
先决条件
Git Claude Code (npm install -g @anthropic-ai/claude-code)推荐 ：jq （用于钩子验证）和 Python 3（用于 JSON 验证） 如果缺少可选工具，所有钩子都会优雅地失败——不会破坏任何东西，只是失去验证功能。
设置
克隆或用作模板 ：
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
打开 Claude Code 并启动会话：
claude
运行 /start — 系统会询问你当前所处阶段（没有想法、概念模糊、
设计清晰、已有作品），并引导你进入正确的工作流程。不做任何假设。
如果你已经知道自己需要什么，也可以直接跳转到特定技能：
/brainstorm — 从零开始探索游戏创意/setup-engine godot 4.6 — 如果你已经知道，配置你的引擎/project-stage-detect — 分析现有项目
升级 已经在使用此模板的旧版本？请参阅 UPGRADING.md
获取分步迁移说明、版本间变更明细，以及哪些文件可以安全覆盖、哪些需要手动合并。
项目结构 CLAUDE.md # Master configuration
.claude/
settings.json # Hooks, permissions, safety rules
agents/ # 49 agent definitions (markdown + YAML frontmatter)
skills/ # 73 slash commands (subdirectory per skill)
hooks/ # 12 hook scripts (bash, cross-platform)
rules/ # 11 path-scoped coding standards
statusline.sh # Status line script (context%, model, stage, epic breadcrumb)
docs/
workflow-catalog.yaml # 7-phase pipeline definition (read by /help)
templates/ # 41 document templates
src/ # Game source code
assets/ # Art, audio, VFX, shaders, data files
design/ # GDDs, narrative docs, level designs
docs/ # Technical documentation and ADRs
tests/ # Test suites (unit, integration, performance, playtest)
tools/ # Build and pipeline tools
prototypes/ # Throwaway prototypes (isolated from src/)
production/ # Sprint plans, milestones, release tracking
工作原理
代理协调
垂直委派 — 总监委派给主管，主管委派给专家横向咨询 — 同层级的代理可以互相咨询，但不能做出具有约束力的跨领域决策冲突解决 — 分歧上报给共同的上级（creative-director 负责设计，technical-director 负责技术）变更传播 — 跨部门的变更由 producer 协调领域边界 — 未经明确委派，代理不得修改其领域之外的文件
协作而非自治 这不是 一个自动驾驶系统。每个代理都遵循严格的协作协议：
询问 — 代理在提出解决方案之前先提问提供选项 — 代理展示 2-4 个选项，并附上优缺点由你决定 — 最终决定权始终在用户手中草稿 — 代理在定稿前展示工作成果批准 — 未经你的签字确认，任何内容都不会被写入 你始终掌控全局。代理提供的是结构和专业知识，而非自主权。
自动化安全
注意 ：validate-commit.sh, validate-assets.sh 和 validate-skill-change.sh 会在每次 Bash/Write 工具调用时触发，并在命令或文件路径不相关时立即退出（exit 0）。这是正常的钩子行为 — 并非性能问题。
权限规则 在 settings.json 中自动允许安全操作（如 git status、测试运行），并阻止危险操作（如强制推送、rm -rf、读取 .env 文件）。
路径作用域规则
设计理念
MDA 框架 — 用于游戏设计的机制、动态、美学分析自我决定理论 — 自主性、胜任感、归属感，用于玩家动机心流状态设计 — 挑战与技能的平衡，用于玩家参与度巴特尔玩家类型 — 受众定位与验证验证驱动开发 — 先测试，后实现
自定义
添加/移除代理 — 删除不需要的代理文件，为你的领域添加新代理编辑代理提示词 — 调整代理行为，添加项目特定知识修改技能 — 调整工作流程以匹配你团队的流程添加规则 — 为你的项目目录结构创建新的路径作用域规则调整钩子 — 调整验证严格程度，添加新检查选择引擎 — 使用 Godot、Unity 或 Unreal 代理集（或不用）设置审查强度 — full（所有总监关卡）、lean（仅阶段关卡）或 solo（无）。在 /start 期间设置或编辑 production/review-mode.txt。可在任何技能上使用 --review solo 进行单次运行覆盖。
平台支持 主要在 Windows 10 上使用 Git Bash 进行开发和测试。所有钩子都使用 POSIX 兼容模式（grep -E，而非 grep -P），并为缺失的工具提供回退方案，因此它们应该可以在 macOS 和 Linux 上运行。notify.sh 钩子使用 PowerShell 实现 Windows 通知，在其他平台上是空操作 — macOS/Linux 上的桌面通知尚未接入。跨平台测试正在进行中；如遇任何平台特定问题，请提交 issue。
社区
支持本项目 Claude Code Game Studios 是免费且开源的。如果它为你节省了时间或帮助你发布了游戏，请考虑支持持续开发：
赞助有助于资助维护技能、添加新代理、跟进 Claude Code 和引擎 API 变更以及响应社区问题所需的时间。
许可证 09.08
