SuperAPI AI 工具集

roblox-rojo-workflow

办公与效率

查看项目

更新于 10-16 09:59

技能介绍

用途:面向使用 Rojo 的 Roblox 项目,提供从文件系统到 Studio 的同步工作流,目标是安全理解项目结构、修改源码并避免破坏生成资产。

主要能力: 识别入口,查找 default.project.json 或其他 *.project.json,读取 Rojo tree 确认目录映射到 ReplicatedStorage、ServerScriptService、StarterPlayer、StarterGui 等服务;同时查找 wally.toml、aftman.toml、.luaurc、selene.toml、.stylua.toml。区分源文件和生成物,优先编辑 src/、Packages/ 以外的项目源码,不直接编辑 .rbxl、.rbxm、.rbxlx、.rbxmx,除非用户明确要求并说明来源;不把 Rojo 生成的 sourcemap 当作源码手改。修改代码前建立路径映射,从 project json 推断 Studio 中的 Instance 路径;修改 require 路径时同时检查调用方和依赖方;新增 ModuleScript 时确认其会被 Rojo 映射进预期服务。

使用方式:可用时运行 rojo sourcemap、wally install、stylua --check、selene,以及项目自带的 npm/pesde/lune/aftman 脚本。交付时说明哪些文件会同步到 Studio 哪个服务,是否需要用户在 Studio 里重新连接 Rojo 或 Play Test。输出格式包括 Rojo 映射(项目文件路径到 Studio 服务路径)、源码改动(具体文件和模块职责)、需要同步(Studio/Rojo 侧动作)、验证(列出运行过的工具)。

适用场景:维护 Rojo 管理的 Roblox 代码库、新增或调整 ModuleScript、修改 require 路径、需要确认文件与 Studio 服务映射关系时。

限制与安全边界:不假设所有 Roblox 项目都用 Rojo;不自动重写项目结构;不删除包管理生成目录,除非用户明确要求;不把 Studio 中的手动对象改动当作已同步事实,需用户提供导出或源码映射。