用途:指导 AI 智能体为 Godot 4.x 编写高质量 GDScript 代码,提供编码标准、架构模式与模板。适用于生成新 GDScript 代码、创建或组织 Godot 场景、设计游戏架构与节点层级、实现状态机/对象池/存档系统、回答 GDScript 模式与 Godot 约定问题、审查代码质量。不适用于 Godot 中的 C#、Godot 3.x、GDExtension/C++ 或可视化脚本。
主要能力:命名规范(类 PascalCase、信号 past_tense_snake_case、常量 SCREAMING_SNAKE_CASE、变量与函数 snake_case、私有成员前加下划线);静态类型提示(变量、函数签名与返回类型、类型化信号、@onready 节点引用);节点引用推荐 @onready 加类型提示与 %UniqueName,避免 _ready() 中 get_node() 和深层脆弱路径;信号驱动架构遵循“信号向上、调用向下”,子节点发信号、父节点连接;资源加载区分 preload()(编译期、小型关键资源)、load()(运行时、可选大型资源)与 ResourceLoader 异步加载;导出注解含 @export、@export_range、@export_group、@export_flags;脚本结构按信号、枚举、导出、常量、公有/私有变量、onready、生命周期、公有/私有方法排序;常见模式含枚举状态机、对象池、基于 Resource 或 JSON 的存档;并列出反模式与替代方案(如用信号替代 _process 轮询、用 is_instance_valid() 替代 node != null、用 await 替代 yield)。
使用方式:作为技能加载后,在生成或审查 GDScript 时按上述规范执行;参考资料含 references/patterns/ 下的状态机、对象池、存档、输入处理,references/architecture/ 下的项目结构、场景组合、节点通信,references/gdscript/ 下的类型系统与协程,以及 assets/templates/ 下的基础脚本、状态机、autoload 管理器模板。
限制:仅限 GDScript,不含 C#、GDExtension 或 VisualScript;仅 Godot 4.x 语法;面向游戏开发模式,不涉及编辑器插件开发;无运行时校验脚本,GDScript 需 Godot 运行时。具体安装命令与收费信息暂未提供。