用途:为 Godot 4 项目建立可维护的基础结构,强调按功能组织文件夹、统一命名与版本控制卫生。
主要能力:核心脚手架(持久型)包括 project_bootstrapper.gd(生成功能文件夹与 .gitignore)、runtime_configurator.gd(应用高性能配置并保存 override.cfg)、managed_autoload.gd、global_event_bus.gd、node_pooling_system.gd、async_resource_loader.gd。运行时工具(无状态)包括 base_data_resource.gd、advanced_telemetry_logger.gd、threaded_task_worker.gd、action_buffer_input.gd、build_metadata_provider.gd、feature_scaffolder.gd、scene_naming_validator.gd。
使用方式:确保存在 project.godot,再运行 project_bootstrapper.gd,生成 entities/、ui/、levels/、common/;配置 Git 的 .gitignore 并在 README.md 记录基于功能的布局;依据所有权决策树注册精简 Autoload。场景切换强制使用 async_resource_loader.gd,全局信号强制使用 global_event_bus.gd。
命名与限制:文件与文件夹用 snake_case,节点用 PascalCase,导出变量用 snake_case,私有成员前加 _,信号用过去式 snake_case,唯一引用使用 %SceneUniqueNames。禁止按文件类型分组、禁止硬编码 get_node() 路径、禁止单体式 Autoload、禁止提交 .godot/、禁止对原始设计源文件跳过 .gdignore、禁止直接修改全局共享 Resource、禁止在主线程用 load()、禁止后台线程改 SceneTree、禁止跳过 Mutex、禁止用 _process() 处理精确输入。新项目可在项目设置中将未类型化声明设为 Warn 或 Error。完整命名表与迁移细节见 references/foundations-deep.md。官方文档与相关技能按需加载,不要预载全部。收费、价格与平台暂未提供。