Godogen 资产生成器
为 Godot、Bevy 与 Babylon.js 游戏项目自动生成图像、GLB 3D 模型、绑定角色和逐帧动画精灵的代理技能。
证据显示 API 密钥均通过环境变量读取、不落盘;每次付费生成前明确要求与用户确认,费用表公开透明;Tripo 侧车文件避免重复扣费并支持免费恢复,失败路径清楚。扣分:无用户确认机制代码层面的强制(确认仅为文档指令),无回滚机制,发布者身份未经注册表验证,外部效果(付费调用、文件写入)未做隔离沙箱说明。
脚本自洽性良好:JSON 标准输出/错误路径一致、参数校验、非 biped 时提前中止并给出替代建议、超时恢复路径完整。扣分:无测试覆盖,依赖的 tripo3d / xai_sdk / google.genai 模块签名无法静态验证(如 gemini-3.1-flash-image-preview 版本号可疑),GEMINI_COSTS 等硬编码可能漂移,静态评审按锚点不得高于 10。
适用场景明确(游戏美术资产生成),触发条件、输入输出格式、成本边界、非适用范围(纹理不需 rembg、quadruped 用 glb)均有说明。扣分:核心功能完全依赖 Gemini/xAI/Tripo3D 等海外付费 API,对中国大陆网络可达性构成实质障碍;allow_implicit_invocation 为 true,'生成美术'类宽泛请求可能误触发付费调用。
文档分层清晰(SKILL.md → rembg.md → 工具脚本),成本表、示例、已知缺陷(方向感弱、锯齿修复)披露充分,仓库有 MIT 许可和 CHANGELOG 引用。扣分:skill 自身无版本号/变更记录,asset_gen.py 的 Python 依赖(xai_sdk、google-genai、tripo3d)未见 requirements 文件,维护责任仅通过个人 Twitter 指向,发布者未经注册表验证。
成本量化、双模型选型建议、防重复扣费、循环帧检测、资产清单规范等展现出显著的手工操作之外的实际价值,输出为可直接使用的 PNG/GLB。扣分:静态评审无法验证生成质量与关键路径可复现性,'low'置信度下按锚点不得高于 7,且效果依赖外部 API 输出质量。
代码与文档相互印证,成本与参数在 SKILL.md 和 asset_gen.py 中一致,属可审计的一手材料。扣分:无 CI 工作流或提交的测试套件覆盖关键路径,演示仅为 YouTube 视频链接(静态不可核验),无第三方执行证据,按锚点不得高于 5。
- 核心功能依赖 Gemini、xAI、Tripo3D 等海外付费 API,中国大陆网络环境下可能无法直接访问,且每次调用产生真实费用,需预先准备 API 密钥并确认计费。
- allow_implicit_invocation 为 true,宽泛的'生成美术'类请求可能意外触发付费调用;建议在敏感环境中显式要求确认。
- asset_gen.py 的依赖(xai_sdk、google.genai、tripo3d 模块)与成本数字为硬编码,未提供 requirements 文件且无测试,版本漂移时可能静默失败,使用前应自行验证。
- 发布者身份未经 FollowSkills 注册表验证,维护与更新路径依赖个人渠道。
这个 Skill 能做什么,适合哪些场景?
Godogen 是一个面向自主游戏开发的仓库,提供跨引擎的资产生成技能(asset-gen)。它调用 Gemini 与 xAI Grok 生成 PNG 图像、调用 Tripo3D 把参考图转成 GLB 3D 模型、为双足角色做绑定与动画重定向,并通过视频抽帧加抠图制作动画精灵。所有生成调用都是付费 API,技能内置了成本参考、失败恢复(如 Tripo3D 任务续跑防止重复扣费)和资产清单规范。仓库本身不是游戏,而是一个发布器:选择引擎和宿主代理(Claude 或 Codex)后发布到新的游戏仓库,由代理在其中构建实际游戏。
读取项目根目录下的技能工具脚本,按文本提示生成 PNG 图像(Gemini:512/1K/2K/4K;Grok:2¢,质量高但服从性差);支持图生图(--image 传参考图)、用 grid_slice.py 切分素材包、rembg 抠图;通过'参考图→姿态→视频→抽帧→循环裁剪→抠图'流程制作动画精灵(视频 5¢/秒,720p,1–15 秒);调用 Tripo3D 将图像转 GLB(30¢,HD 60¢)、双足绑定(+25¢)和约百种动画预设重定向(每段 10¢);Tripo3D 超时可通过 sidecar 任务 id 用 resume 免费续跑;每条命令输出 JSON(含 cost_cents),要求在 README.md 维护带游戏内尺寸的资产清单。
- 独立开发者想让 Claude Code 根据一句游戏描述自主完成 Godot 4(C#/.NET)项目搭建、资产生成并给出可运行证明。
- Rust/Bevy 开发者需要代码优先的 ECS 场景加离屏捕获,并自动生成配套纹理和简单物件。
- Web 游戏开发者想发布 Babylon.js/TypeScript 项目,由代理在浏览器中构建并给出实时 URL 或录屏验证。
- 需要为角色批量产出动作的团队:一张参考图驱动多个动作姿态、视频抽帧成精灵动画,且动作链保持位置连续性。
- 预算敏感的创作者想明确每步成本(纹理 2¢、参考图 7¢、完整 3D 资产 37¢、绑定角色动画约 92¢)后再决定生成方案。
这个 Skill 有哪些优点和局限?
- 端到端覆盖图像、3D、绑定、动画重定向和精灵动画,一条技能管线即可产出游戏视觉资产。
- 成本透明:文档给出每项操作的具体价格并要求生成前与用户确认。
- 工程细节扎实:Tripo3D 超时防重复扣费、循环帧检测、方向翻转省费、资产清单含游戏内尺寸列。
- 支持 Claude 与 Codex 双宿主、Godot/Bevy/Babylon.js 三引擎,发布时按需渲染。
- 每次调用都是真实付费 API(Grok 2¢ 起,完整绑定角色流程约 92¢),实验成本累积明显。
- 依赖多个外部 API 密钥和较多系统包(ffmpeg、ImageMagick、vulkan-tools 等),环境搭建门槛高。
- 生成模型空间感弱:方向不可靠、小尺寸精灵易糊,需要人工审查每张 PNG 再转 3D。
- 仅在 Ubuntu、Debian 和 macOS 上测试过;仓库未提及测试套件,Windows 未验证。
- 完整生成可能耗时数小时,通常需要服务器或 GPU 实例。
如何安装这个 Skill?
前置条件:Godot 4 .NET 版、Rust/Cargo、Node.js 22.12+、支持 WebGL2 的 Chrome/Chromium、Python 3 + pip、ffmpeg、ImageMagick、vulkan-tools、xvfb,以及 GOOGLE_API_KEY、XAI_API_KEY、TRIPO3D_API_KEY 环境变量。已测试于 Ubuntu、Debian 和 macOS。然后用 publish.sh 发布游戏仓库:./publish.sh --engine godot --agent claude --out ~/my-game(也可选 babylon/bevy 与 codex;--force 可清空目标目录后重发)。发布后 Claude 得到 CLAUDE.md + .claude/skills/,Codex 得到 AGENTS.md + .agents/skills/。
如何使用这个 Skill?
在发布出的游戏仓库中启动 Claude Code 或 Codex,技能默认提示为:'Use ${ASSET_SKILL_COMMAND} to generate images, 3D models, or animated sprites for this game.',且允许隐式触发。生成图像示例:python3 ${ASSET_GEN_SKILL_DIR}/tools/asset_gen.py image --prompt "..." -o ${RUNTIME_ASSET_DIR}/img/car.png;3D:asset_gen.py glb/rig/retarget 子命令。可在本地运行或放到服务器(建议 GPU 实例,配合 tmux/screen 与远程控制接口)进行数小时的无人值守运行。
这个 Skill 与同类方案有什么区别?
与手工作坊式的 AI 资产流程相比,Godogen 把图像、视频与 3D 生成串成带成本控制和失败恢复的自动化管线,并强调'以运行中的游戏为证'而非编译通过即交付;它明确面向 Claude Code 与 Codex 两类宿主代理,这是普通单文件技能所不具备的。