## 项目概述

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. **克隆仓库**：
   ```bash
   git clone https://github.com/Donchitos/Claude-Code-Game-Studios.git my-game
   cd my-game
   ```
2. **安装 Claude Code**：
   ```bash
   npm install -g @anthropic-ai/claude-code
   ```
3. **启动会话**：
   ```bash
   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 仓库：https://github.com/Donchitos/Claude-Code-Game-Studios
- 最新发布：https://github.com/Donchitos/Claude-Code-Game-Studios/releases/tag/v1.0.0
- 讨论区：https://github.com/Donchitos/Claude-Code-Game-Studios/discussions
- 问题跟踪：https://github.com/Donchitos/Claude-Code-Game-Studios/issues

## 信息来源和分析时间

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