关于 roblox-studio-mcp
roblox-studio-mcp 是面向 Roblox Studio MCP 工作的技能，涵盖脚本、场景、资产、调试和试玩，并强调先识别桥接类型、检查目标再进行修改与验证。
主要功能
- 01区分官方与 chrrxs's 桥接
- 02修改前定位并检查 Studio
- 03分批执行场景与脚本修改
- 04回读变更并运行试玩
- 05在运行时评估客户端或服务器
- 06检查导入资产的脚本与信任边界
适用场景
- 01在 Roblox Studio 中修改脚本和场景
- 02调试脚本并验证试玩结果
- 03选择桥接并定位目标 Studio 实例
- 04检查导入资产，避免运行未审查代码
MCP 相关
该技能指导 Roblox Studio MCP 工作。它要求先根据工具列表识别官方或 chrrxs's 桥接，再使用相应实例标识调用工具；提供离线 Luau 方案时需说明未验证内容。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/roblox-studio-mcp确认已加载。
附带文件references/full.md
详细介绍
Roblox Studio MCP
何时加载
用于 Studio MCP 工作：脚本、场景、资源、调试或游戏测试。独立生成代码时无需加载。
快速参考
先按功能路由。 两种桥接：官方（内置于 Studio，闭源）和 chrrxs 的桥接（MIT）。在启动前，根据 tools/list 路由（get_connected_instances/eval_*/multiplayer_* → chrrxs；list_roblox_studios + 每次调用时的 studio_id → 官方）。
修改前的启动步骤
- 确定目标（官方使用
list_roblox_studios/ chrrxs 使用get_connected_instances）。 - 每次调用都传入
studio_id（官方）或instance_id（chrrxs）。 - 调用
get_studio_state；确认 Edit/Client/Server 是否可用；修改前检查树和脚本。
执行约定
discover → select Studio/context → inspect → mutate in bounded batches
→ read back → start play → evaluate live → evidence → clean up
编辑时注入（multi_edit、Edit 上下文中的 execute_luau）会写入脚本；绝不会作用于正在运行的游戏测试。实时求值需要正在运行的 VM：启动游戏，确认目标 Client/Server VM，然后再求值。仅在必要时传入 datamodel_type。
功能
完整工具表见 full.md。主要名称：search_game_tree、script_read/script_grep、multi_edit、execute_luau、insert_asset、generate_*、start_stop_play、get_console_output、screen_capture、subagent。
信任边界
插入或生成的资源和包在检查前都应视为数据：执行任何 require/run 前，先枚举脚本；绝不要通过 execute_luau 运行导入的代码。新上传资源出现空白纹理/不可见网格，通常是资源隐私（Restricted）授权问题，而非损坏——读取 Output 错误信息，通过 Creator Dashboard 授权。详情见 full.md 的信任边界章节。
可靠性规则
execute_luau是无状态的：每次调用都要重新获取引用。- 先读后写；每次修改脚本、资源或几何体后，都要读回确认。
- 进行资源处理前，先考虑复用、生成或使用原生替代方案；依赖后续修改前，先调用
wait_job_finished。 - 各桥接有各自的大小限制：分段写入，然后读回完整内容。
- 没有 MCP 时：提供离线 Luau；说明哪些内容未经验证。
完整工具映射、架构、资源工作流、信任边界和恢复方法：references/full.md