About roblox-rojo-workflow
Roblox Rojo Workflow is a skill for safely understanding and editing Roblox projects synchronized from the filesystem to Studio through Rojo. It emphasizes project-to-Studio path mapping, distinguishing source from generated assets, and validating changes with available tools.
Key features
- 01Inspect project configuration and Rojo mappings
- 02Distinguish source files from generated assets
- 03Check Studio paths before changing requires
- 04Run available Rojo and Luau tooling
- 05Report synchronization and verification steps
Use cases
- 01Safely modify source in a Rojo project
- 02Add a ModuleScript at the intended Studio path
- 03Check project changes before syncing to Studio
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/roblox-rojo-workflowin Claude Code to confirm it loaded.
Details
From the project READMERoblox 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 sourcemapwally installstylua --checkselene- 项目自带 npm/pesde/lune/aftman 脚本
- 交付时说明：
- 哪些文件会同步到 Studio 哪个服务。
- 是否需要用户在 Studio 里重新连接 Rojo 或 Play Test。
安全边界
- 不假设所有 Roblox 项目都用 Rojo。
- 不自动重写项目结构。
- 不删除包管理生成目录，除非用户明确要求。
- 不把 Studio 中的手动对象改动当作已同步事实；需要用户提供导出或源码映射。
输出格式
- Rojo 映射：项目文件路径到 Studio 服务路径。
- 源码改动：具体文件和模块职责。
- 需要同步：Studio/Rojo 侧需要执行的动作。
- 验证：列出运行过的 Rojo/Wally/Luau 工具。
Comments
Markdown supported