本文深入解析GitHub高星项目Claude Code Game Studios，拆解其48个分层Agent、37个Skills与8个Hooks的真实架构。面向游戏开发者与AI研究者，揭示其设计思路为多引擎专家协作与自动化校验，但并非适合所有游戏场景，亦未达到行业颠覆。提供客观技术分析，帮助理性看待AI在游戏开发中的应用。
Tags:
这是熊猫的第346篇原创
最近确实是有点沉迷AI，文章写得少了。
老是给我推荐「Claude Code Game Studios」这个项目的文章
就是下图这个项目，目前已经有了7.1k的star。
标题基本上都是AI要颠覆游戏行业/这48个agent多强大......等等。
按照这个方式去写文章制造焦虑的人，要么不懂游戏，要么不懂AI。
我看了下这个项目，确实是有48个agent智能体，37个skills，还有8个hooks。
这个项目里的官方名册：48 个人设 = 3 层岗位 + 三大引擎各一套专家。每个人设的特点，用「管什么 / 什么时候找他」来说最贴切，我用白话翻译了下：
第一层：领导三人组（Tier 1，建议 Opus）
| creative-director（创意总监） | |
| technical-director（技术总监） | |
| producer（制作人） |
第二层：部门负责人（Tier 2）
| game-designer（游戏设计师） | |
| lead-programmer（主程） | |
| art-director（美术总监） | |
| audio-director（音频总监） | |
| narrative-director（叙事总监） | |
| qa-lead（测试负责人） | |
| release-manager（发行/发布负责人） | |
| localization-lead（本地化负责人） |
第三层：执行专家（Tier 3）
| systems-designer（系统设计师） | |
| level-designer（关卡设计师） | |
| economy-designer（经济/数值设计师） | |
| gameplay-programmer（玩法程序员） | |
| engine-programmer（引擎程序员） | |
| ai-programmer（AI 程序员） | |
| network-programmer（网络程序员） | |
| tools-programmer（工具程序员） | |
| ui-programmer（UI 程序员） | |
| technical-artist（技术美术） | |
| sound-designer（音效设计师） | |
| writer（文案） | |
| world-builder（世界构建） | |
| qa-tester（测试执行） | |
| performance-analyst（性能分析） | |
| devops-engineer（DevOps） | |
| analytics-engineer（数据/分析工程） | |
| ux-designer（UX 设计师） | |
| prototyper（原型师） | 快速验证 |
| security-engineer（安全工程师） | |
| accessibility-specialist（无障碍专家） | |
| live-ops-designer（长线运营设计） | |
| community-manager（社区运营） |
引擎总专家（三选一，按你项目引擎用）
| unreal-specialist | |
| unity-specialist | |
| godot-specialist |
Unreal 子专家（4 人）
| ue-gas-specialist | |
| ue-blueprint-specialist | |
| ue-replication-specialist | |
| ue-umg-specialist |
Unity 子专家（4 人）
| unity-dots-specialist | |
| unity-shader-specialist | |
| unity-addressables-specialist | |
| unity-ui-specialist |
Godot 子专家（3 人）
| godot-gdscript-specialist | |
| godot-shader-specialist | |
| godot-gdextension-specialist |
主要针对3个引擎：ue,unity,godot。
名册里会给部分人设标 Sonnet / Haiku / Opus，意思是：建议用更重的模型做战略与复杂推理，用更轻的模型做文档、检查表、社区类杂务。这不是文件里写死的程序逻辑，而是给调度/使用时的建议档位。
你会发现，这48个agent，不会完全出现，如果你用unity，就不会调用 godot agent，也就是不会出现48个agent给你干活的情况。
大部分人都是在瞎写。
然后是37个skills：
37 个工作流（命令名 = 文件夹名）
/start | ||
/design-review | ||
/code-review | ||
/playtest-report | ||
/balance-check | ||
/sprint-plan | ||
/bug-report | ||
/architecture-decision | ||
/asset-audit | ||
/milestone-review | ||
/onboard | ||
/prototype | ||
/release-checklist | ||
/changelog | ||
/retrospective | ||
/estimate | ||
/hotfix | ||
/tech-debt | ||
/scope-check | ||
/localize | ||
/perf-profile | ||
/project-stage-detect | ||
/reverse-document | ||
/team-combat | ||
/team-narrative | ||
/team-ui | ||
/team-release | ||
/team-polish | ||
/team-audio | ||
/team-level | ||
/launch-checklist | ||
/patch-notes | ||
/brainstorm | ||
/gate-check | ||
/map-systems | ||
/design-system | ||
/setup-engine |
然后是8个hooks，这些是claude/hooks/ 里是 8 个 Bash 脚本，配合 .claude/settings.json 里的 hooks 配置，在 Claude Code 的特定时机自动执行。它们做的是：灌上下文、做校验、打日志，不是业务游戏逻辑。
Hooks 在「什么时候」跑？
| SessionStart | session-start.shdetect-gaps.sh | |
| PreToolUse | validate-commit.shvalidate-push.sh | git commit / git push 时先检查 |
| PostToolUse | validate-assets.sh | assets/ |
| PreCompact | pre-compact.sh | |
| Stop | session-stop.sh | |
| SubagentStart | log-agent.sh |
每个脚本具体在干什么？
session-start.sh
打印分支、最近几条 commit、当前 sprint/milestone 文件名、未关闭 Bug 数量、 src里 TODO/FIXME 数量。若存在 production/session-state/active.md，提示「有上次会话状态」并预览前几行。
detect-gaps.sh
判断是否全新工程（未配引擎、无 game-concept、无源码）：提示跑/start、/project-stage-detect。否则检查「有代码/原型但缺文档」等情况，提醒补文档（具体规则在脚本后半段）。
validate-commit.sh（仅当 Bash 命令是 git commit 时）
暂存区里若有 design/gdd/：检查是否含规定章节（Overview、Player Fantasy 等）。assets/data/**/*.json：用 Python 校验 JSON，无效则拦截提交（exit 2）。 src/gameplay/：疑似硬编码数值会 警告。 src/下：TODO/FIXME 若不符合 TODO(name)格式会 警告。警告不挡提交（除 JSON 无效外）。
validate-push.sh（仅当 Bash 命令是 git push 时）
检测是否往 main/master/develop 等保护分支推，给出 警告（是否强拦看脚本后半，前面读到的是 warn）。
validate-assets.sh（Write/Edit 之后）
仅当改的是 assets/下文件：检查命名（小写+下划线等）、JSON 合法性，输出 警告（PostToolUse 一般不用于阻断）。
pre-compact.sh
在上下文被压缩前：打印时间戳、 active.md摘要、当前工作区改动文件等，帮会话「续命」。
session-stop.sh
把 production/session-state/active.md归档到production/session-logs/，写会话结束记录（commit、未提交改动等）。
log-agent.sh
从 stdin 的 JSON 里取出 agent_name，追加写入production/session-logs/agent-audit.log。
Hooks = Claude Code 生命周期里的自动小管家：开会话时补项目情报、提交/推送前做规则检查、改资源后提醒命名与格式、压缩上下文和结束会话时留痕，以及记录子代理调用——全是 shell 校验 + 日志，和 .claude/skills/ 里的流程说明是不同层的东西（skills 教 AI 怎么做；hooks 在关键节点自动跑固定检查）。
结语
没有评论:
发表评论