Claude Code Game Studios

Claude Code Game Studios将一个普通的 Claude Code 会话，升级为一个结构严密、分工明确的游戏开发工作室。

这不仅仅是调用一个 AI 助手，而是部署一支由 48 个专业智能体 组成的虚拟团队，运行 37 个标准化工作流程，在统一的协调机制下协同作业。

为什么要构建这个系统？

单独使用 AI 辅助游戏开发确实强大，但单一的聊天会话存在天然的结构性缺陷：

• 缺乏约束：没有机制阻止你硬编码魔法数字、跳过设计文档或写出难以维护的“意大利面条式”代码。
• 缺失环节：没有独立的 QA 测试，没有设计审查，没有人会追问“这真的符合游戏的核心愿景吗？”
• 视野局限：单一模型难以同时兼顾宏观架构与微观实现，容易陷入局部优化而忽略整体一致性。

Claude Code Game Studios 旨在解决上述痛点。它不是提供一个通用的聊天机器人，而是将真实游戏工作室的组织架构引入你的 AI 会话中。

在这个系统中，你不再是孤军奋战。你拥有的是一个层级分明的团队：

• 导演层：守护项目愿景，把控整体方向。
• 主管层：负责各自专业领域（程序、美术、策划等）的技术决策。
• 专员层：执行具体的代码编写、资源制作和测试任务。

每个智能体都有明确的职责边界、升级路径和质量关卡。最终的控制权依然在你手中，但你现在拥有一个能主动提出关键问题、及早识别潜在风险、并从头脑风暴阶段一直护航到产品发布的智能团队。

核心资产清单

该项目不仅仅是一组提示词，而是一套完整的工程化体系：

工作室层级架构

智能体团队严格模拟真实工作室的协作模式，分为三个层级：

第 1 层：决策与愿景（导演组）

负责把握项目的灵魂与可行性。

• Creative Director (创意总监)：确保所有产出符合核心愿景。
• Technical Director (技术总监)：把控技术选型与架构稳定性。
• Producer (制作人)：协调资源，管理进度与风险。

第 2 层：领域统筹（部门主管）

负责各自专业领域的标准制定与任务分发。

• 游戏设计、主程序、美术总监、音频总监、叙事总监。
• QA 主管、发布经理、本地化主管。

第 3 层：执行专家（专员组）

负责具体落地执行，涵盖细分职能。

• 程序类：游戏玩法、引擎、AI、网络、工具、UI 程序员。
• 设计类：系统、关卡、经济设计师。
• 内容与体验：技术美术、声音设计师、编剧、世界构建师、UX 设计师、原型制作师。
• 支持与运营：性能分析、DevOps、数据分析、安全工程师、QA 测试员、可访问性专员、运营设计师、社区经理。

引擎适配专员

为了适应不同的技术栈，模板内置了针对三大主流游戏引擎的专属智能体集。系统会根据你的项目配置，自动激活对应的专家组合：

37 个即时可用工作流

在 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 等：调用特定领域的专家团队进行联合攻关。

快速开始指南

前置要求

• 已安装 Git
• 已配置 Claude Code
• 推荐安装：jq (JSON 处理) 和 Python 3

部署步骤

# 1. 克隆项目仓库
git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game

# 2. 进入项目目录
cd my-game

# 3. 启动 Claude Code
claude

启动后，输入 /start 命令。系统将自动询问你当前的开发阶段，并引导你进入相应的工作流。

如果你已有明确目标，也可直接调用特定技能：

• /brainstorm：从零开始探索游戏创意
• /setup-engine godot 4.6：一键配置 Godot 引擎环境
• /project-stage-detect：分析现有项目结构并生成报告

核心运行机制

1. 结构化智能体协调

智能体之间并非杂乱无章地对话，而是遵循严格的委托模型：

• 垂直委托：导演向主管下达目标，主管向专员分配具体任务。
• 横向咨询：同级别智能体（如主程与主美）可相互咨询，但无权直接修改对方领域的核心文件。
• 冲突升级：当出现跨领域分歧时，自动上报至共同上级（如制作人或总监）裁决。
• 变更传播：涉及多部门的变更，由制作人统一协调同步。
• 领域隔离：智能体严禁在未获明确委托的情况下，修改其职责范围之外的文件。

2. “人在回路”的协作原则

这不是一个全自动的黑盒系统，而是一个增强人类决策的透明工具。每个智能体都遵循以下协议：

1. 先问后做：在提出解决方案前，必须先澄清需求和约束。
2. 提供选项：永远给出 2-4 个可行方案，并详细列出利弊权衡。
3. 用户决策：你拥有最终决定权，选择哪个方案由你说了算。
4. 草稿预览：在正式写入文件前，必须展示工作草稿。
5. 显式批准：未经你的明确确认（Approve），任何代码或文档都不会被修改。

智能体提供的是结构与专业知识，而非自主控制权。

3. 自动化安全护栏

系统内置了 8 个自动化钩子（Hooks），在关键节点自动运行验证：

• validate-commit.sh：提交前检查硬编码值、TODO 格式、JSON 有效性及设计文档完整性。
• validate-push.sh：在向受保护分支推送时发出二次确认警告。
• validate-assets.sh：校验资源文件的命名规范与数据结构。
• session-start.sh：自动加载当前的冲刺上下文与最近的 Git 活动记录。
• detect-gaps.sh：扫描新项目，识别缺失的关键文档或配置。
• pre-compact.sh：在会话压缩前保存进度快照，防止上下文丢失。
• session-stop.sh：会话结束时自动记录完成的工作项。
• log-agent.sh：对所有子智能体的调用进行审计追踪，确保行为可追溯。

配合权限规则，系统会自动放行安全操作，并拦截高危指令。

4. 路径作用域规则 (Path-Scope Rules)

编码标准不再依赖口头约定，而是基于文件路径自动强制执行：

• src/gameplay/**：强制要求使用数据驱动的值，禁止硬编码，强制使用时间增量。
• src/ai/**：强制执行性能预算（如每帧最大计算耗时），强制保留调试接口。
• src/networking/**：强制服务器权威架构，强制消息版本化管理。

设计理念溯源

本模板并非凭空想象，而是深度植根于成熟的专业游戏开发理论与实践：

• MDA 框架：从机制 (Mechanics)、动态 (Dynamics) 到美学 (Aesthetics) 的系统化分析。
• 自我决定理论：在设计中融入自主性、胜任感与关联性，提升玩家体验。
• 心流通道设计：动态平衡挑战难度与玩家技能水平。
• Bartle 玩家类型：针对成就型、探索型、社交型、杀手型玩家进行受众验证。
• 验证驱动开发：倡导先定义成功标准（测试），再进行功能实现。

高度可定制化

这是一个模板，而非封闭的黑盒框架。一切皆为定制而生：

• 增删智能体：根据项目规模调整团队配置。
• 编辑提示词：微调智能体的性格、语气与专业侧重。
• 修改工作流：适配团队特有的开发习惯。
• 自定义规则：添加项目独有的路径作用域规范。
• 调整钩子：根据需求放宽或收紧自动化验证的严格度。
• 引擎切换：自由选择在 Godot、Unity 或 Unreal 之间切换。

平台兼容性

本项目已在 Windows 10 (Git Bash) 环境下完成全面测试。

所有自动化钩子均采用兼容 POSIX 标准的脚本编写，并内置了工具缺失时的回退机制。无需任何修改，即可直接在 macOS 和 Linux 系统上运行，实现跨平台无缝开发。