分享一个开源项目 godot-skill：让 Claude Code / Codex 真正会写 Godot 项目

项目地址： https://github.com/haxqer/godot-skill

起因

用 AI agent 写 Godot 项目时，卡住的地方通常不是 GDScript 本身，而是工程结构：

• .tscn / .tres 虽然是纯文本，但 UID 、ext_resource 引用一手写就容易写坏，编辑器打开一堆红；


• 改完没法自证，得人肉打开 Godot 才知道有没有炸；


• TileSet 、SpriteFrames 、AnimationPlayer 、AudioBusLayout 这类资源，纯手写基本不现实。

所以把这套东西打包成了一个 skill ，让 agent 用脚本去操作工程，而不是靠猜格式。

能做什么

• 场景与资源编辑：事务式批量修改节点、属性、布局 override ，挂脚本、连信号、重构节点树；项目设置、InputMap 、autoload 、shader globals 、多人复制配置


• 内容制作：TileSet / TileMapLayer 与 GridMap 绘制、Theme / StyleBox 、SpriteFrames 图集动画、AnimationPlayer 关键帧、音频总线路由


• 烘焙：mesh / CSG 碰撞、精灵轮廓描边碰撞、2D / 3D 导航网格、glTF 导出


• 调试验证：headless 跑项目，日志解析成结构化诊断；对 script / scene / shader / resource 做静态校验；确定性输入 + 截图场景；运行时与性能验证


• 测试：GUT / GdUnit4 无头运行


• 导出：Android / iOS / Web / Windows / Linux / macOS / 服务端 / visionOS 预设校验与导出


• 杂项：导入设置审计、UID 修复、抠图（ chroma key ）等资源管线小工具

针对 Godot 4.7 设计，兼容 4.x 。

怎么装

从源码：把 skill/godot/ 拷进你的 skills 目录。

从 release：解压 dist/godot.zip 到 skills 目录，包里已经带了顶层的 godot/ 目录。

Claude Code 和 Codex 都能直接加载。

项目还比较早期，有在折腾 Godot 的朋友欢迎试试。缺什么能力、或者踩到坑了都可以提 issue ，PR 更好。