关于 roblox-tooling
roblox-tooling 是面向 Roblox 开发的技能,涵盖文件工作流、工具版本固定、代码检查、sourcemap 和 CI。它强调编辑前先确认 Studio 或文件哪一方是事实来源。
主要功能
- 01Rojo 与 Wally 项目工作流
- 02工具版本固定指导
- 03Selene 与 StyLua CI 检查
- 04Lune 与 Rojo sourcemap
- 05CI 结果解析与测试套件拆分
- 06安全更新脚本源码
适用场景
- 01设置 Roblox 项目文件与依赖
- 02为 CI 添加代码检查和测试门禁
- 03处理 Studio 与磁盘同步冲突
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ tabooharmony/ roblox-brain --skill roblox-tooling安装后在 Claude Code 中输入/roblox-tooling确认已加载。
附带文件references/full.md
详细介绍
Roblox 工具
何时加载
适用于文件系统工作流、工具/包版本锁定、Lint、源码映射和 CI。
快速参考
- 文件是事实来源时使用 Rojo;清单和锁文件使用 Wally(明确指定 realm)。通过项目的管理器锁定工具;新项目优先使用 Rokit(Aftman 已归档,但仍会读取
aftman.toml)。 - 在 CI 中使用 Selene + StyLua 检查模式(不静默重写);使用 Lune 运行独立的 Luau;使用 Rojo 源码映射支持编辑器工具。
- CI 根据解析结果和计数进行门禁检查,而非退出码;将逻辑、文件、HTTP 和引擎测试套件分开(见 full.md)。
先明确事实来源。 编辑前先确认使用的是 Studio 还是文件;切勿假设二者已同步。rojo syncback 会拉取已保存的 place 编辑内容,而非进行实时双向同步——先试运行。不要强加可选工具。TestEZ 已归档:在已使用它的地方继续保留。
通过插件/MCP 写入脚本时,使用 ScriptEditorService:UpdateSourceAsync(直接写入 .Source 可能覆盖打开的编辑器内容),并且每次有界变更只记录一次 ChangeHistoryService。解决 Script Sync 冲突时,可选择 Keep Studio 或 Keep Disk——切勿假设哪一方会胜出。参见 full.md §§1b–1d。
详情: references/full.md(设置、文件布局、CI 示例)。
评论
支持 Markdown