Godot 技能用于以无图形界面方式检查与修改 Godot 项目，配合内置工作流、脚本以及宿主环境可用的 Godot 自动化工具，也涵盖玩法呈现类工作，例如美术生成、逐帧动画集成，以及将提供或单独生成的音乐与剧情内容集成进项目。技能已在 Godot 4.7 上验证，兼容 Godot 4.x。
用途与任务路由 技能按任务类型给出应读取或运行的脚本与验证方式，例如：从零新建项目使用 scripts/project/scaffold_project.py DEST --preset pixel2d|hd2d|3d|ui；查询引擎类、方法、信号或常量使用 scripts/docs/api_lookup.py；玩家控制器、敌人、伤害、生命、投射物、波次、状态机、瓦片关卡、菜单与主题、HUD、暂停、对话、分支对话、设置、物品、背包、掉落、存档读档、小型完整游戏、像素美术、音效与音乐、着色器、场景淡入淡出、GDScript 编写与编辑、Godot 3 迁移、自定义数据、手写 .tscn/.tres、文件移动重命名、参数查询、快速逻辑检查、节点配置问题、运行时错误、场景与输入路径错误、单元测试、无视觉听觉验证、空间验证、导出打包等，均有对应的脚本、模板或参考文档。
主要能力 技能提供项目脚手架、API 查询、GDScript 模板（玩家、状态机、HUD、存档、菜单、对话控制器等）、着色器模板（24 个已验证 .gdshader）、像素美术绘制与处理、音效与音乐生成、单元测试框架、空间验证、导出预检等能力。模板为 Godot 4.7、完全类型化并验证零警告编译，文件头说明所需场景树、autoload 与输入动作，并给出 attach_script 调用。带 class_name 的模板复制后需执行一次 godot --headless --path /absolute/project --import。
使用方式 使用前先确认宿主代理中可用的 Godot 自动化路径，优先使用原生或已映射的 Godot 工具；仅在支持的文件与场景操作中使用内置 headless dispatcher。宿主工具需要时，将 project_path 解析为绝对项目目录；直接使用内置脚本时，将场景与资源路径规范为 res://...。检查陌生项目时使用可用的项目发现工具，或直接读取 project.godot、场景文件与脚本。涉及美术、音乐或剧情时，先检查现有视觉风格、调色板、音频方向与叙事格式。用户未指定风格时，优先保留项目已有方向；若无既定方向，新视觉工作默认采用像素美术风格并保持相关呈现选择一致。
验证与检查 技能强调通过命令验证结果，例如 validate.counts 的 errors 与 warnings 均为 0、run_scenario.py 返回 "ok": true、lint_project.py 的 counts.errors == 0、check_project 的 failed_count == 0、run_tests.py 返回 "ok": true 等。lint_project.py 无需 Godot，可在不到一秒内报告 Godot 自身消息隐藏的问题，包括 Godot 3 API、语法与着色器名称的 4.x 替换、无法解析的输入动作、组、res:// 路径与动画名、无法解析的 := 读取、指向不存在节点的 $Path/%Name 引用、缺少 unique_name_in_owner 的 %Name、方法缺失的 [connection] 目标、磁盘上不存在的 ext_resource/autoload 路径等。error 表示 Godot 将拒绝解析或引用无法解析；warning 表示可编译但有风险。
适用场景 适用于需要无图形界面搭建、检查、修改 Godot 4.x 项目的场景，包括新建项目、编写与检查 GDScript、搭建玩家与敌人逻辑、制作瓦片关卡、设计菜单与 HUD、实现存档与背包、生成像素美术与音效音乐、编写着色器、运行单元测试、进行空间验证、迁移 Godot 3 项目、打包导出等。
限制与注意事项 使用内置 dispatcher 回退、运行时运行器或 CLI 导出包装器前，需要本地 godot CLI 与 shell 访问权限。不要在 shell 中直接 mv、cp 或重命名项目内文件，应使用 scripts/project/move_resource.py，否则可能静默破坏项目。手写 .tscn/.tres 文本时，节点层级可能静默失败，例如所有节点 parent="." 会零错误加载但把所有 Control 堆叠在 (0,0)，且 check_project 无法检测。部分操作仅限编辑器，不应在 headless 下尝试，例如 LightmapGI/occluder/reflection-probe 烘焙与 VisualShader 图。POT 模板生成在 Godot 4.x 中仅限编辑器。安装技能时文件夹名应为 godot，以匹配 name: godot。