Donchitos / Claude-Code-Game-Studios

Donchitos/Claude-Code-Game-Studios

open_in_new前往仓库

将Claude Code转变为完整的游戏开发工作室——包含49个AI代理、72项工作流技能，以及模拟真实工作室层级的完整协调系统。

项目概览

项目概述

Claude Code Game Studios 是一个将 Claude Code 会话转变为完整游戏开发工作室的开源模板。它通过 49 个专业 AI 代理、73 个工作流技能、12 个自动化钩子和 11 条路径作用域规则，模拟真实游戏工作室的层级结构，为独立游戏开发者提供结构化的 AI 辅助开发流程。项目采用 MIT 许可证，主要使用 Shell 脚本编写，旨在解决单一 AI 会话缺乏结构、容易产生混乱代码的问题。

核心功能

  • 49 个专业代理：分为三层（总监、部门主管、专家），覆盖设计、编程、美术、音频、叙事、QA 和生产等所有领域。
  • 73 个斜杠命令：覆盖从头脑风暴、系统设计、架构决策、故事拆分、开发实施、QA 测试到发布的全流程。
  • 12 个自动化钩子：在会话开始、提交、推送、资源变更等事件时自动执行验证，确保代码质量和流程规范。
  • 11 条路径作用域规则：根据文件路径自动应用编码标准，例如 src/gameplay/** 强制数据驱动值，src/ai/** 强制性能预算。
  • 41 个文档模板：包括 GDD、UX 规范、ADR、冲刺计划等，确保文档结构完整。
  • 协作式设计原则：强调用户驱动，代理必须提问、提供选项、等待用户批准后才写入文件。
  • 引擎支持：内置 Godot 4、Unity、Unreal Engine 5 的专家代理集和版本锁定参考文档。

适用与不适用场景

适用场景：

  • 独立游戏开发者希望利用 AI 辅助开发，但需要保持对创意和决策的控制。
  • 需要结构化流程来管理复杂游戏项目，从概念到发布。
  • 希望使用 Claude Code 进行团队协作式开发，但缺乏内部流程规范。
  • 需要跨领域协调（如设计、编程、美术、音频）的项目。

不适用场景：

  • 完全自动化的游戏开发（系统明确不是自动驾驶）。
  • 非游戏开发项目（模板高度针对游戏开发流程）。
  • 不需要严格文档和流程的快速原型或游戏 jam（但提供 solo 审查模式）。
  • 没有 Claude Code 环境的用户。

技术架构与依赖

  • 核心依赖：Claude Code（npm install -g @anthropic-ai/claude-code）、Git。
  • 可选依赖：jq（钩子验证）、Python 3（JSON 验证）。
  • 架构：基于 .claude/ 目录，包含 agents/（代理定义）、skills/（技能）、hooks/（钩子脚本）、rules/（规则）、docs/（文档和模板）。
  • 引擎参考：docs/engine-reference/ 包含版本锁定的引擎 API 快照，弥补 LLM 知识截止日期。
  • 平台：主要支持 Windows 10 + Git Bash，钩子使用 POSIX 兼容模式，理论上支持 macOS 和 Linux。

安装与快速开始

  1. 克隆仓库： 
    git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
cd my-game
  2. 安装 Claude Code： 
    npm install -g @anthropic-ai/claude-code
  3. 启动会话： 
    claude
  4. 运行 /start：系统会询问当前项目状态，并引导至相应工作流。
  5. 验证钩子：启动会话时，应看到 session-start.sh 钩子的输出。

典型使用方法

  • 从零开始：运行 /brainstorm 生成概念，/setup-engine 配置引擎，/map-systems 分解系统，然后按阶段推进。
  • 已有设计：使用 /design-review 验证 GDD，/create-architecture 创建架构，/create-epics 和 /create-stories 拆分故事，/sprint-plan 规划冲刺。
  • 复杂功能：使用团队技能如 /team-combat 协调多个代理并行工作。
  • 发布：使用 /release-checklist 和 /launch-checklist 进行发布前验证。

配置与部署要点

  • 审查模式：通过 production/review-mode.txt 设置 full、lean 或 solo，或使用 --review 标志覆盖。
  • 引擎选择：在 /setup-engine 中选择 Godot、Unity 或 Unreal，系统会加载相应专家代理。
  • 自定义：可以添加/删除代理、修改技能、调整钩子严格度。
  • 钩子依赖：确保 jq 和 Python 可用，否则钩子会优雅降级。
  • 跨平台：钩子使用 POSIX 兼容模式，但 notify.sh 仅支持 Windows。

限制、风险与许可证

  • 限制：系统不是自动驾驶，需要用户积极参与决策；主要针对游戏开发，其他领域可能不适用。
  • 风险：依赖 Claude Code 和外部工具；引擎版本更新可能导致参考文档过时；跨平台测试仍在进行中。
  • 许可证：MIT License。

官方链接

信息来源和分析时间

  • 信息来源：GitHub 仓库 README、CONTRIBUTING.md、WORKFLOW-GUIDE.md、COLLABORATIVE-DESIGN-PRINCIPLE.md、engine-reference 文档。
  • 分析时间：2026-05-13（基于最新发布版本）。