liang's Godogen: 使用 Claude Code 构建完整 Godot 4 项目的技能集
你描述你想要的内容。AI pipeline 会设计架构、生成美术资源、编写每一行代码、从运行的游戏引擎中截取截图，并修复看起来不对的地方。输出是一个真正的 Godot 4 项目，包含组织良好的场景、可读的脚本和正确的游戏架构。支持 2D 和 3D，可在普通硬件上运行。
特别感谢佬友支持： linux.do
功能特点
- 三个 Claude Code skills — 一个编排器在单个 100万 token 上下文中运行完整 pipeline（规划、构建、调试），而两个分支支持 skills 处理 Godot API 查询和可视化 QA，不会污染主上下文。
- Godot 4 输出 — 真正的项目，包含正确的场景树、脚本和资源组织。
- 资源生成 — Gemini 创建精确的参考图和角色；xAI Grok 处理纹理和简单物体（可选）；Tripo3D 将图片转换为 3D 模型。动画精灵使用 Gemini nano gif生成并检测循环。预算意识：最大化每分钱产生的视觉效果。
- GDScript 专业知识 — 自定义构建的语言参考和延迟加载的 API 文档，覆盖所有 850+ Godot 类，弥补 LLM 在 GDScript 训练数据上的不足。
- 可视化 QA 闭环 — 从运行的游戏中捕获实际截图，使用 Gemini Flash 和 Claude vision (或者国内视觉大模型也可以) 进行分析。包含自由形式可视化调试的问答模式。能捕捉 z-fighting、缺失纹理、物理破损等问题。
- 可在普通硬件上运行 — 任何装有 Godot 和 Claude Code 的 PC 都能工作。
新增文档
本项目新增了以下功能文档，详细说明各模块的使用方法：
| 文档 | 说明 |
|---|---|
| visual-qa.md | 可视化质量保证，使用 Gemini Flash 和 Claude vision 进行截图分析和问答 |
| android-build.md | Android APK 导出配置和构建流程 |
| sprite-gen.md | 2D 精灵图动画生成，通过 302.ai API 创建角色动画序列 |
| capture.md | 游戏截图和视频捕获，支持 macOS 和 Linux 平台 |
| test-harness.md | 测试框架和可视化验证，SceneTree 脚本编写规范 |
快速开始
环境要求
- Godot 4（headless 或 editor）已在 PATH 中
- 已安装 Claude Code
- API keys 环境变量：
- Python 3 + pip（资源工具会自动安装依赖）
- 系统包：
mesa-utils、ffmpeg（详细说明见 setup.md，包含 macOS） - 测试环境：Ubuntu、Debian 和 macOS
其实就是配置一个 302.ai API API key 就可以运行了：
# Linux/macOS
export THREE_ZERO_TWO_AI_KEY="your-api-key"
# Windows PowerShell
$env:THREE_ZERO_TWO_AI_KEY="your-api-key"
利用了302.ai 以下api:
REWRITE_ENDPOINT = "https://api.302ai.cn/v1/chat/completions"
REWRITE_MODEL = "gemini-3.1-flash-image-preview"
SPRITE_ENDPOINT = "https://api.302.ai/ws/api/v3/google/nano-banana-2/text-to-image"
SPRITE_EDIT_ENDPOINT = "https://api.302.ai/ws/api/v3/google/nano-banana-2/edit"
API_URL = "https://api.302.ai/recraft/v1/images/removeBackground"
创建游戏项目
此仓库是 skill 开发源码。要开始制作游戏，运行 publish.sh 设置包含所有 skills 安装的新项目文件夹：
./publish.sh ~/my-game ./publish.sh --force ~/my-game # 清理现有目标后重新发布
这会创建目标目录，包含 .claude/skills/ 和 CLAUDE.md，然后初始化 git 仓库。在该文件夹中打开 Claude Code，告诉它要制作什么游戏 — /godogen skill 会处理后续一切。
在 VM 上运行
单次生成可能需要数小时。在云 VM 上运行可保持本地机器空闲，并为 Godot 的截图捕获提供 GPU。基本的 G4/T4 或 L4 GPU 的 GCE 实例即可。
无需保持终端打开整个运行过程。连接一个 channel（Telegram、Slack 等）来从手机发送提示并接收进度更新，或使用 remote control 从任何浏览器管理会话。
Claude Code 是唯一选择吗？
这些 skills 在不同设置下进行了测试。Claude Code 配合 Opus 4.6 可获得最佳结果。Sonnet 4.6 也可以工作，但需要用户更多指导。OpenCode 相当不错，移植 skills 也很简单——如果你在寻找替代方案，推荐它。
功能概览
可视化 QA（visual-qa）
运行在分支上下文中，使用 Claude 原生 vision。包含三种模式：
- 静态模式：无运动场景（装饰、地形、UI）
- 动态模式：有运动、动画或物理的场景
- 问答模式：调试和调查，可针对截图提出任何问题
Android 构建
支持将 Godot 项目导出为 debug APK。包含完整的 export_presets.cfg 配置模板和常见问题排查。
精灵图动画生成
通过 302.ai nano-banana-2 API 生成 NxN 动画精灵图。支持多种动画类型：idle、walk、run、attack、cast、jump、dance、death、dodge。
截图和视频捕获
支持 macOS（Metal）和 Linux（X11/xvfb + 可选 GPU）。硬件渲染时支持视频导出。
开源项目继承
本项目是继承自 https://github.com/htdt/godogen 项目的，添加了很多功能和优化。更适合国内用户使用，更方便更实用，让Godogen 更加方便地用于游戏开发。 项目地址：Godogen