项目地址: 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 更好。