Technology Stack【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-StudiosEngine: [CHOOSE: Godot 4 / Unity / Unreal Engine 5]Language: [CHOOSE: GDScript / C# / C / Blueprint]Version Control: Git with trunk-based developmentBuild System: [SPECIFY after choosing engine]Asset Pipeline: [SPECIFY after choosing engine]关键点解读 - **引擎三选一**Godot 4、Unity、Unreal Engine 5 是 CCGS 官方支持的三大引擎。选择引擎后Claude Code 会加载对应的一套引擎专家代理。仓库 [.claude/agents/](https://link.gitcode.com/i/3053c99ab18395808116829e04a05c2f) 中按引擎分组的子专家如下 | 引擎 | 主专家代理 | 子专家代理 | |------|-----------|-----------| | Godot 4 | godot-specialist | godot-gdscript-specialist、godot-shader-specialist、godot-csharp-specialist、godot-gdextension-specialist | | Unity | unity-specialist | unity-ui-specialist、unity-shader-specialist、unity-dots-specialist、unity-addressables-specialist | | Unreal Engine 5 | unreal-specialist | ue-gas-specialist、ue-replication-specialist、ue-umg-specialist、ue-blueprint-specialist | - **版本控制固定为 trunk-based**主干开发这与 Git 工作流、commit 校验 hooksvalidate-commit.sh相互配合。 - **构建系统与资产管线**CLAUDE.md 刻意要求选择引擎后再指定因为不同引擎的构建/资产管线差异巨大避免过早做无关决策。 CLAUDE.md 中的 Note 特别提醒**使用与所选引擎匹配的那一套专家代理**而不是混用。这正是代理职责边界原则在引擎维度上的体现。具体到文件路由[src/CLAUDE.md](https://link.gitcode.com/i/5ce6555bebc230027000965222c28803) 进一步说明将文件类型与引擎专家代理匹配并指向 CLAUDE.md → Technical Preferences → Engine Specialists → File Extension Routing。 ## 三、引擎版本参考对抗 LLM 知识缺口的防线 CLAUDE.md 以 docs/engine-reference/godot/VERSION.md 的形式固定引擎版本参考。这一机制的背景在 [VERSION.md](https://link.gitcode.com/i/a9dbcfe0b258f019d35a0912bbe8fbc4) 中写得很直白 The LLMs training data likely covers Godot up to ~4.3. Versions 4.4, 4.5, and 4.6 introduced significant changes that the model does NOT know about. Always cross-reference this directory before suggesting Godot API calls. 也就是说**Claude 的训练数据存在知识截止点**而引擎在持续演进。以 Godot 为例仓库记录的版本时间线[docs/engine-reference/godot/VERSION.md](https://link.gitcode.com/i/a9dbcfe0b258f019d35a0912bbe8fbc4) | 版本 | 发布时间 | 风险等级 | 关键变化 | |------|---------|---------|---------| | 4.4 | 约 2025 年中 | MEDIUM | Jolt 物理可选、FileAccess 返回类型、shader 纹理类型变更 | | 4.5 | 约 2025 年末 | HIGH | 无障碍AccessKit、可变参数、abstract、shader baker、SMAA | | 4.6 | 2026 年 1 月 | HIGH | Jolt 默认、glow 重做、Windows 默认 D3D12、IK 恢复 | 这份版本档案还记录了引擎固定版本4.6、文档最后核验日期2026-02-12与 LLM 知识截止点2025 年 5 月。[src/CLAUDE.md](https://link.gitcode.com/i/5ce6555bebc230027000965222c28803) 中将其固化为铁律**Do not guess at post-cutoff API signatures — look them up first.**不要猜测知识截止点之后的 API 签名——先查文档。仓库中 Unity 与 Unreal 引擎也有对应的 [VERSION.md](https://link.gitcode.com/i/7b9548a46ceeaa97fe4477a87960927c) 与 [VERSION.md](https://link.gitcode.com/i/85aea9fb69aa0e232a4c0214336d0a52)以及配套的 breaking-changes.md、deprecated-apis.md、current-best-practices.md构成完整的引擎 API 事实源。 这是一项非常实用的工程实践把模型不知道的新 API显式建文档管理而不是让 AI 凭记忆猜测。 ## 四、协作协议Question → Options → Decision → Draft → Approval CLAUDE.md 中最核心、也最具辨识度的是 **Collaboration Protocol** 一节。它旗帜鲜明地声明 **User-driven collaboration, not autonomous execution.**用户驱动的协作而非自主执行。 随后给出五步强制流程**Question提问→ Options选项→ Decision决策→ Draft草稿→ Approval批准**并落实到四条硬性规则 1. 代理在使用 Write/Edit 工具**前必须询问**May I write this to [filepath]? 2. 代理在请求批准前**必须先展示草稿或摘要** 3. 多文件变更**必须为完整 changeset 显式申请批准** 4. **没有用户指令不得提交 commit**。 这份协议的完整版沉淀在 [docs/COLLABORATIVE-DESIGN-PRINCIPLE.md](https://link.gitcode.com/i/08a5242bf81cc43c92cc18874aeb0060) 中它把两种模型做了正反对照 - **正确模型——协作顾问Collaborative Consultant**代理提问澄清、研究并呈现选项、解释权衡与推理、起草方案供审阅、获准后才写入文件用户是创意总监Final Decision Maker掌握所有决策权。 - **错误模型——自主生成器Autonomous Generator**代理直接生成并写入、未经输入就做决策、未经批准就写代码、用户只丢一句做个游戏然后干等。 协议还给出了完整的工作流示例以设计合成系统为例代理先问配方应靠探索发现还是 NPC 传授失败惩罚多严厉实验是否有资源成本用户回答后代理给出 3 个带优劣对比的选项如 Full Randomized Discovery / Ingredient Hint System / Hybrid用户选定后代理起草机制与公式草稿如 failure_xp success_xp * 0.15经用户调参25% XP 太慷慨改成 15%后最终询问May I write this to design/gdd/crafting-system.md?得到是才落盘。 对于需要结构化决策的场景协议推荐使用 AskUserQuestion 工具呈现 2-4 个可选 UI 选项并采用 **Explain → Capture** 两步模式先以正文给出完整推理再用 UI 收集决策。同时有明确的取舍建议开放式探索问题你对 roguelike 的兴奋点在哪、单一 yes/no 确认、Task 子代理场景不要用该工具。 另一个重要实践是 **增量写作Incremental Section Writing**对含多个章节的文档逐节批准后写入而非在对话中一次性构建全文。其动机在文档中有量化说明一个含 8 章节、每节 2-3 轮修订的完整设计会话会累积 30k-50k token 的对话增量写作将活跃上下文压到约 3-5k token已完成的章节持久化到磁盘即便会话压缩或崩溃代理也能通过读取文件与 production/session-state/active.md 恢复进度。这直接呼应了 CLAUDE.md 中 Context Management 的存在价值。 最后协议提供了一个快速自检清单任何交互后对照检查代理是否问了澄清问题是否提供了带权衡的多选项最终决策是否由你做出写入文件前是否获得批准是否解释了推荐理由任一答案为否说明协作不够充分。 ## 五、协调规则垂直委派、横向咨询与冲突升级 CLAUDE.md 将协调规则指向 [.claude/docs/coordination-rules.md](https://link.gitcode.com/i/f5b728545169aa90ea7719e1c016f03f)其中定义了 5 条代理间协作铁律 1. **垂直委派Vertical Delegation**领导代理委派给部门主管主管委派给专家复杂决策不得越级。 2. **横向咨询Horizontal Consultation**同层代理可相互咨询但不得做出跨域绑定决策。 3. **冲突解决Conflict Resolution**两代理意见不合时升级至共同父级无共同父级时设计冲突升级至 creative-director技术冲突升级至 technical-director。 4. **变更传播Change Propagation**设计变更涉及多领域时由 producer 代理协调传播。 5. **禁止单方面跨域修改**未经明确委派代理不得改动其指定目录之外的文件。 这与 README 中描述的How It Works完全一致垂直委派 横向咨询 冲突升级 变更传播 领域边界构成工作室层级Directors → Leads → Specialists的运转规则。 ### 模型层级分配Model Tier Assignment 协调规则文档进一步按任务复杂度给代理和技能分配模型层级这是成本控制的直接手段 | 层级 | 模型 | 适用场景 | |------|------|---------| | Haiku | claude-haiku-4-5-20251001 | 只读状态检查、格式化、简单查询——无需创意判断 | | Sonnet | claude-sonnet-4-6 | 实现、设计撰写、单系统分析——默认选项 | | Opus | claude-opus-4-6 | 多文档综合、高风险的阶段门禁裁决、跨系统整体审查 | 仓库中已标注 model: haiku 的技能包括 /help、/sprint-status、/story-readiness、/scope-check、/project-stage-detect、/changelog、/patch-notes、/onboard标注 model: opus 的包括 /review-all-gdds、/architecture-review、/gate-check其余技能默认 Sonnet。 ### 子代理 vs 代理团队 该文档还区分了两种多代理模式 - **子代理Subagents当前默认且始终启用**在单个 Claude Code 会话内通过 Task 生成team-* 系列技能均基于此共享会话权限上下文可顺序或并行执行结果返回父会话。文档特别给出并行时机若两个子代理输入相互独立应同时发起两个 Task 调用例如 /review-all-gdds 的 Phase 1 一致性检查与 Phase 2 设计理论审查相互独立应并行。 - **代理团队Agent Teams实验性、需显式开启**多个独立 Claude Code 会话并发运行通过共享任务列表协调需设置环境变量 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS1。适用条件是工作横跨多个互不触碰同一文件的子系统、各工作流超过 30 分钟且受益于真正并行、资深代理technical-director、producer需要同时协调 3 个专家会话。注意其成本与限制每个成员独立消耗 token输出互为输入的场景应改用顺序子代理。 ### 并行任务协议 当编排技能同时生成多个独立代理时文档要求先发出所有独立 Task 调用再等待结果收集全部结果后才进入依赖阶段任何代理 BLOCKED 必须立即上报不得静默跳过即使部分代理完成、部分阻塞也总是产出部分报告。 ## 六、编码标准与上下文管理 CLAUDE.md 将编码标准指向 [.claude/docs/coding-standards.md](https://link.gitcode.com/i/bbf6a5d2ed4a1f192f8bf9740d2bd67d)其核心约束包括 - 所有公开 API 需要 doc comments - 每个系统须在 docs/architecture/ 有对应的架构决策记录ADR - **游戏玩法数值必须数据驱动**外部配置文件严禁硬编码 - 所有公开方法须可单元测试依赖注入优先于单例 - commit 必须引用对应的设计文档或任务 ID - **验证驱动开发Verification-Driven Development**添加游戏系统时先写测试UI 变更用截图验证标记完成前将期望输出与实际输出对比。 测试证据要求按故事类型分级[.claude/docs/coding-standards.md](https://link.gitcode.com/i/bbf6a5d2ed4a1f192f8bf9740d2bd67d) | 故事类型 | 所需证据 | 存放位置 | 门禁级别 | |---------|---------|---------|---------| | 逻辑公式、AI、状态机 | 自动化单元测试——必须通过 | tests/unit/[system]/ | BLOCKING | | 集成多系统 | 集成测试或文档化 playtest | tests/integration/[system]/ | BLOCKING | | 视觉/手感动画、VFX | 截图 主管签字 | production/qa/evidence/ | ADVISORY | | UI菜单、HUD、界面 | 手动走查文档或交互测试 | production/qa/evidence/ | ADVISORY | | 配置/数据数值调优 | 冒烟检查通过 | production/qa/smoke-[date].md | ADVISORY | 同时明确**不应自动化**的范畴视觉保真shader 输出、VFX 外观、动画曲线、手感输入响应、感知重量、节奏、平台相关渲染、完整游戏会话由 playtest 覆盖。CI/CD 规则要求每次 push 到 main 与每个 PR 都跑测试套件、测试失败即阻止合并、禁止禁用或跳过失败测试并给出三引擎的 headless 测试命令Godot: godot --headless --script tests/gdunit4_runner.gdUnity: game-ci/unity-test-runnerv4Unreal: -nullrhi headless runner。 上下文管理由 .claude/docs/context-management.md 提供策略并与 production/session-state/active.md会话状态跟踪、增量写作、pre/post-compact hooks 协同工作。 ## 七、底层支撑设施settings.json、Hooks 与路径级 Rules 根 CLAUDE.md 未展开的自动化工序实际由 [.claude/settings.json](https://link.gitcode.com/i/c1f76925078602717754f93a87a3cedc) 承载它同时定义了权限与 hooks 两大机制。 ### 权限模型Permissions permissions 自动放行安全操作如 git status*、git diff*、ls *、python -m pytest*并**阻断危险操作** json deny: [ Bash(rm -rf *), Bash(git push --force*), Bash(git reset --hard*), Bash(git clean -f*), Bash(sudo *), Bash(chmod 777*), Read(**/.env*) ]从源码结构看这套 allow/deny 白名单机制与 CLAUDE.md无用户指令不得提交、禁止越权操作的协作协议互为表里。Hooks 自动校验hooks 在会话生命周期事件上自动触发全部为 POSIX 兼容的 bash 脚本位于 .claude/hooks/共 12 个关键清单如下Hook触发时机作用validate-commit.shPreToolUse (Bash)检查硬编码值、TODO 格式、JSON 有效性、设计文档章节非git commit命令立即提前退出validate-push.shPreToolUse (Bash)推送受保护分支时告警非git push提前退出validate-assets.shPostToolUse (Write/Edit)校验资产命名约定与 JSON 结构非assets/文件提前退出session-start.sh会话打开显示当前分支与近期提交用于方向定位detect-gaps.sh会话打开检测新项目建议运行/start以及有代码/原型但缺设计文档的情况pre-compact.sh/post-compact.sh压缩前后保存进度笔记 / 提醒从active.md恢复会话状态log-agent.sh/log-agent-stop.sh子代理启停子代理审计轨迹记录validate-skill-change.shPostToolUse建议在.claude/skills/变更后运行/skill-testREADME 特别说明validate-commit.sh、validate-assets.sh、validate-skill-change.sh会在每次 Bash/Write 工具调用时触发并在不相关时立即以 exit 0 退出这是 hook 的正常行为而非性能问题。所有 hooks 采用grep -E而非grep -P等 POSIX 兼容写法并在缺少可选工具如 jq、Python 3时优雅降级——校验功能失效但流程不中断。路径级 Rules编码标准按文件路径自动生效.claude/rules/ 下 11 个规则文件路径强制内容src/gameplay/**数据驱动数值、delta time 使用、禁止引用 UIsrc/core/**热路径零分配、线程安全、API 稳定性src/ai/**性能预算、可调试性、数据驱动参数src/networking/**服务器权威、版本化消息、安全src/ui/**不持有游戏状态、可本地化、无障碍design/gdd/**8 个必需章节、公式格式、边界情况tests/**测试命名、覆盖要求、fixture 模式prototypes/**宽松标准、必须 README、记录假设八、从根 CLAUDE.md 起步首次会话与 /startCLAUDE.md 在协作协议末尾专门为首次使用者留下一句提示First session?If the project has no engine configured and no game concept, run/startto begin the guided onboarding flow.也就是说如果项目尚未配置引擎、也没有游戏概念不要自己硬闯直接运行/start进入引导流程。该技能位于 .claude/skills/start/会先询问使用者所处阶段毫无概念 / 模糊构想 / 已有明确设计 / 已有存量代码再导向对应的技能路径全程不做假设。前置条件来自 README.md安装 Git、Claude Codenpm install -g anthropic-ai/claude-code推荐安装 jqhook 校验用与 Python 3JSON 校验用。上手流程git clone https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios.git my-game cd my-game claude【免费下载链接】Claude-Code-Game-StudiosTurn Claude Code into a full game dev studio — 49 AI agents, 72 workflow skills, and a complete coordination system mirroring real studio hierarchy.项目地址: https://gitcode.com/GitHub_Trending/cl/Claude-Code-Game-Studios创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
