用 Claude Code Skills 完整开发 Godot 游戏

面向 Godot、Bevy 和 Babylon.js，使用 Claude Code 与 Codex 进行自主游戏开发。

观看演示 · Prompts

描述一款游戏。Agent 会构建游戏、生成素材、运行引擎并验证结果——你在场时，可以观看并操控实时运行的游戏；你不在场时，则会得到录制的视频。在运行过程中，Agent 会根据实际情况自行判断采用哪种方式。

这个 repo 本身不是游戏，而是一个游戏生成器的源码，其工作流程是：godogen -> game repo -> game。你需要先将其发布到一个全新的 game repo，并选择游戏引擎和 host-agent 类型；随后，Agent 会在该 repo 内运行，根据一份简短的引擎指南构建真正的游戏。

发布后的 repo 会刻意保持精简，只包含 runtime manifest、一页式引擎指南和素材生成 skill。其余所有内容，包括项目脚手架和录制工具，都会由 Agent 根据指南重新创建。

• prompts/runtime.md — runtime manifest
• asset-gen/ — 跨引擎素材生成 skill
• engines/babylon.md、engines/godot.md、engines/bevy.md — 各引擎对应的指南
• publish.sh — 根据所选引擎和 host agent 渲染 runtime 布局

引擎和 host agent（Claude 或 Codex）是在发布时进行渲染的选项，而不是相互独立的源码树。

• Godot 4 — 使用 C#/.NET 的项目，支持构建时场景生成、runtime scripts 和 Jolt physics。
• Bevy — 使用 Rust/Bevy 的项目，采用 code-first ECS 场景并支持 offscreen capture。
• Babylon.js — 使用 TypeScript/Vite 的浏览器游戏，通过实时 URL 提供访问。
• 素材生成 — 使用 Gemini 生成精确的参考图和角色，使用 xAI Grok 生成纹理和简单物体，使用 Tripo3D 完成 image-to-3D 和带骨骼的双足角色动画；动画 sprites 则通过 Grok video 生成，并进行循环检测和背景移除。
• 以验证结果为准，而非仅凭声称 — Agent 会根据实际运行中的游戏结果（实时 URL 或录制片段）进行判断，而不是以成功编译作为完成标准，因此任何可见缺陷都会推动下一轮迭代。
• 参与程度由你决定 — 你可以观看实时游戏（Babylon.js URL，或者由你运行的 Godot/Bevy 项目），并在决策节点进行引导；也可以让整个过程无人值守，最后获得一段 15–20 秒的验证录像。Agent 会根据你描述任务的方式判断该如何配合。

Godot 项目要求 PATH 中包含 Godot 4（.NET build）。

Bevy 项目要求安装 Rust/Cargo。

Babylon.js 项目要求安装 Node.js 22.12+ 和 npm。

Babylon.js 浏览器录制要求安装支持硬件 WebGL2 的 Chrome 或 Chromium。

API keys 需设置为环境变量：

• GOOGLE_API_KEY — 用于通过 Google AI Studio 调用 Gemini 生成图像

• XAI_API_KEY — 用于通过 xAI Grok 生成图像和视频

• TRIPO3D_API_KEY — 用于通过 Tripo3D 生成 3D 内容

• GOOGLE_API_KEY — 用于通过 Google AI Studio 调用 Gemini 生成图像

• XAI_API_KEY — 用于通过 xAI Grok 生成图像和视频

• TRIPO3D_API_KEY — 用于通过 Tripo3D 生成 3D 内容

还需要安装 setup.md 中列出的系统软件包：vulkan-tools、xvfb、ffmpeg、imagemagick，以及各平台特有的额外依赖。

已在 Ubuntu、Debian 和 macOS 上完成测试。

选择引擎和 host agent：

./publish.sh --engine godot   --agent claude --out ~/my-game       # CLAUDE.md + .claude/skills/
./publish.sh --engine babylon --agent codex  --out ~/my-game       # AGENTS.md + .agents/skills/
./publish.sh --engine bevy    --agent claude --out ~/my-game

传入 --force，可在重新发布前清空目标位置中的现有内容。

一次完整的生成过程可能需要数小时，因此将任务交给服务器运行会更加方便。最好使用 GPU 实例，因为硬件加速能够显著提升引擎渲染和视频录制速度。

使用 tmux 或 screen，即使 SSH 连接中断，也能让 session 持续运行。

启用远程控制后，你可以通过任何设备随时查看并引导运行过程——Claude Code 和 Codex 都提供官方的远程控制界面。

关注进展：@alex_erm