Claude Code Game Studios

将单个 Claude Code 会话转变为完整的游戏开发工作室。
48 个 Agent。37 个工作流。一个协调一致的 AI 团队。

## 为什么选择这个项目 独自使用 AI 构建游戏虽然强大——但单一的聊天会话缺乏结构。没有人阻止你对魔数进行硬编码、跳过设计文档或编写面条式代码。没有 QA 评审，没有设计审查，也没有人问“这是否真的符合游戏的愿景？” **Claude Code Game Studios** 通过为你的 AI 会话提供真实工作室的结构来解决这个问题。与其拥有一个通用助手，你将获得 48 个组织成工作室层级的专门化 Agent——负责把控愿景的总监、负责各自领域的部门主管，以及进行实际工作的专家。每个 Agent 都有明确的职责、升级路径和质量门控。 结果是：你仍然做出每一个决定，但现在你有一个团队，他们会提出正确的问题，及早发现错误，并让你的项目从第一次头脑风暴到发布都保持井井有条。 ## 目录 - [包含内容](#whats-included) - [工作室层级](#studio-hierarchy) - [斜杠命令](#slash-commands) - [快速开始](#getting-started) - [升级指南](#upgrading) - [项目结构](#project-structure) - [工作原理](#how-it-works) - [设计理念](#design-philosophy) - [自定义](#customization) - [平台支持](#platform-support) - [社区](#community) - [许可证](#license) ## 包含内容 | 类别 | 数量 | 描述 | |----------|-------|-------------| | **Agents** | 48 | 跨设计、编程、美术、音频、叙事、QA 和制作的专门化子 Agent | | **技能** | 37 | 用于常见工作流的斜杠命令（`/start`、`/sprint-plan`、`/code-review`、`/brainstorm` 等） | | **Hooks** | 8 | 针对 commit、push、资源变更、会话生命周期、agent 审计和缺口检测的自动化验证 | | **规则** | 11 | 编辑玩法、引擎、AI、UI、网络代码等时强制执行的路径范围编码标准 | | **模板** | 29 | GDD、ADR、Sprint 计划、经济模型、派系设计等文档模板 | ## 工作室层级 Agent 被组织成三个层级，符合真实工作室的运作方式： ``` 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 ``` ### 引擎专家 该模板包含所有三大主要引擎的 Agent 集合。请使用与您项目匹配的集合： | 引擎 | 负责 Agent | 子专家 | |--------|-----------|-----------------| | **Godot 4** | `godot-specialist` | GDScript、Shaders、GDExtension | | **Unity** | `unity-specialist` | DOTS/ECS、Shaders/VFX、Addressables、UI Toolkit | | **Unreal Engine 5** | `unreal-specialist` | GAS、Blueprints、Replication、UMG/CommonUI | ## 斜杠命令 在 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` **团队编排**（协调多个 Agent 处理单一功能） `/team-combat` `/team-narrative` `/team-ui` `/team-release` `/team-polish` `/team-audio` `/team-level` ## 快速开始 ### 前置条件 - [Git](https://git-scm.com/) - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (`npm install -g @anthropic-ai/claude-code`) - **推荐**：[jq](https://jqlang.github.io/jq/)（用于 hook 验证）和 Python 3（用于 JSON 验证） 如果缺少可选工具，所有 hooks 都会优雅地失败——不会出问题，只是会失去验证功能。 ### 设置 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](UPGRADING.md) 获取分步迁移说明、版本间变更细目， 以及哪些文件可以安全覆盖与哪些需要手动合并。 ## 项目结构 ``` CLAUDE.md # Master configuration .claude/ settings.json # Hooks, permissions, safety rules agents/ # 48 agent definitions (markdown + YAML frontmatter) skills/ # 37 slash commands (subdirectory per skill) hooks/ # 8 hook scripts (bash, cross-platform) rules/ # 11 path-scoped coding standards docs/ quick-start.md # Detailed usage guide agent-roster.md # Full agent table with domains agent-coordination-map.md # Delegation and escalation paths setup-requirements.md # Prerequisites and platform notes templates/ # 28 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 tools/ # Build and pipeline tools prototypes/ # Throwaway prototypes (isolated from src/) production/ # Sprint plans, milestones, release tracking ``` ## 工作原理 ### Agent 协作 Agent 遵循结构化的委派模型： 1. **垂直委派** —— 总监委派给主管，主管委派给专家 2. **横向协商** —— 同级 Agent 可以互相协商，但不能做出跨领域的约束性决定 3. **冲突解决** —— 分歧向上升级至共同父级（设计方面由 `creative-director` 负责，技术方面由 `technical-director` 负责） 4. **变更传播** —— 跨部门变更由 `producer` 协调 5. **领域边界** —— Agent 未经明确委派不得修改其领域之外的文件 ### 协作而非自治 这**不是**一个自动驾驶系统。每个 Agent 都遵循严格的协作协议： 1. **询问** —— Agent 在提出解决方案之前先提出问题 2. **展示选项** —— Agent 展示 2-4 个选项及其优缺点 3. **由你决定** —— 用户始终做出决定 4. **起草** —— Agent 在定稿前展示工作内容 5. **批准** —— 未经你的签字，任何内容都不会被写入 你保持掌控。Agent 提供结构和专业知识，而非自主性。 ### 自动化安全 **Hooks** 在每次会话中自动运行： | Hook | 触发条件 | 功能 | |------|---------|--------------| | `validate-commit.sh` | `git commit` | 检查硬编码值、TODO 格式、JSON 有效性、设计文档章节 | | `validate-push.sh` | `git push` | 推送到受保护分支时发出警告 | | `validate-assets.sh` | 在 `assets/` 中写入文件 | 验证命名约定和 JSON 结构 | | `session-start.sh` | 会话开启 | 加载 Sprint 上下文和最近的 Git 活动 | | `detect-gaps.sh` | 会话开启 | 检测新项目（建议 `/start`）以及当代码/原型存在时缺失的文档 | | `pre-compact.sh` | 上下文压缩 | 保留会话进度笔记 | | `session-stop.sh` | 会话关闭 | 记录成果 | | `log-agent.sh` | Agent 生成 | 所有子 Agent 调用的审计跟踪 | `settings.json` 中的**权限规则**自动允许安全操作（git status、测试运行）并阻止危险操作（force push、`rm -rf`、读取 `.env` 文件）。 ### 路径范围规则 编码标准根据文件位置自动强制执行： | 路径 | 强制执行 | |------|----------| | `src/gameplay/**` | 数据驱动值、delta time 使用、无 UI 引用 | | `src/core/**` | 热路径中零分配、线程安全、API 稳定性 | | `src/ai/**` | 性能预算、可调试性、数据驱动参数 | | `src/networking/**` | 服务器权威、版本化消息、安全性 | | `src/ui/**` | 无游戏状态所有权、本地化就绪、可访问性 | | `design/gdd/**` | 必需 8 个章节、公式格式、边缘情况 | | `tests/**` | 测试命名、覆盖率要求、Fixture 模式 | | `prototypes/**` | 宽松标准、需要 README、文档化假设 | ## 设计理念 此模板基于专业的游戏开发实践： - **MDA Framework** —— 用于游戏设计的机制、动态、美学分析 - **Self-Determination Theory** —— 用于玩家动机的自主性、胜任感、归属感 - **Flow State Design** —— 用于玩家参与度的挑战-技能平衡 - **Bartle Player Types** —— 受众定位和验证 - **Verification-Driven Development** —— 测试先行，然后实现 ## 自定义 这是一个**模板**，而非锁定的框架。一切都是为了自定义而设计的： - **添加/移除 Agent** —— 删除你不需要的 agent 文件，为你的领域添加新文件 - **编辑 Agent 提示** —— 调整 agent 行为，添加项目特定知识 - **修改技能** —— 调整工作流以匹配你团队的过程 - **添加规则** —— 为你项目的目录结构创建新的路径范围规则 - **调整 Hooks** —— 调整验证严格程度，添加新检查 - **选择你的引擎** —— 使用 Godot、Unity 或 Unreal agent 集（或不使用） ## 平台支持 已在 **Windows 10** 上使用 Git Bash 测试。所有 Hooks 均使用 POSIX 兼容模式（`grep -E`，而非 `grep -P`），并包含针对缺失工具的回退机制。无需修改即可在 macOS 和 Linux 上运行。 ## 社区 - **讨论** —— [GitHub Discussions](https://github.com/Donchitos/Claude-Code-Game-Studios/discussions) 用于提问、分享想法和展示你的成果 - **问题** —— [Bug 报告和功能请求](https://github.com/Donchitos/Claude-Code-Game-Studios/issues) *此项目正在积极开发中。Agent 架构、技能和协调系统目前已稳固可用——但还有更多功能即将推出。* ## 许可证 MIT 许可证。详情请见 [LICENSE](LICENSE)。

标签：AI 智能体, Anthropic, CIS基准, Claude Code, Linux 内核安全, LLM 应用, PPID欺骗, Prompt 工程, PyRIT, 代码生成, 协同开发, 多智能体系统, 层级管理, 工作流自动化, 应用安全, 效率工具, 数据管道, 渗透测试工具, 游戏工作室, 游戏开发, 游戏设计, 独立游戏, 网络安全研究, 质量保证, 软件工程, 软件开发框架, 逆向工具, 项目管理