roblox-studio-workflow

Roblox Studio 工作流

用途

当工作需要使用本地 Roblox_Studio MCP 服务时，请使用此技能。整个流程应以实时 Studio 会话为准：连接、检查、读取、编辑、进行游戏测试并检查输出。

启动每个 Roblox MCP 会话

1. 首先运行 list_roblox_studios。
2. 如果打开了多个 Studio，请在进行更改前使用 set_active_studio。
3. 运行 get_studio_state，确认游戏状态和可用的 DataModel 类型。
4. 如果场景中有 ROADMAP.md 或项目说明文件，请先阅读，再决定接下来要构建什么。

工具加载

如果当前 Claude 会话中的 MCP 工具被延迟加载，请使用 Tool Search，在调用前选择所需的确切 mcp__Roblox_Studio__<tool> 名称。

代码更改规则

对于脚本，请遵循以下顺序：

1. 使用 script_search 或 script_grep 定位。
2. 使用 script_read 读取目标。
3. 使用 multi_edit 编辑。
4. 使用 start_stop_play 进行游戏测试。
5. 检查 get_console_output。

切勿编辑当前任务上下文中尚未读取的 Roblox 脚本。

实例与世界更改

• 使用 search_game_tree 查找相关对象。
• 更改特定对象或层级前，使用 inspect_instance 检查。
• 使用 execute_luau 执行小型定向查询、场景设置或一次性验证。
• 对货币、库存、购买、物品发放和进度，优先采用服务端验证和权威服务端逻辑。

资源

• 首先使用 search_asset 搜索现有资源。
• 使用 insert_asset 插入第三方 Creator Store 或库存资源时，先将其放入受控位置。
• 导入任何第三方模型、套件、游戏玩法资源、UI 资源或类似插件的资源后，在信任它或让脚本保持启用之前，运行 roblox-creator-store-security-audit。
• 仅在市场或库存资源不适用时才生成：
  • 使用 generate_mesh 生成一个自定义网格。
  • 使用 generate_material 生成表面外观。
  • 使用 generate_procedural_model 生成可配置的基本形状模型。
• 本地图像或网络图像需要转换为 Roblox 就绪资源时，使用 store_image 或 upload_image。

游戏测试

• 使用 start_stop_play 进行实时验证。
• 使用 character_navigation、user_keyboard_input 和 user_mouse_input 测试游戏玩法和 UI。
• 使用 screen_capture 验证视觉状态。
• 游戏测试后务必检查 get_console_output。

路线图规范

只有在完成实现、测试并获得明确的人工批准后，才能将路线图项目标记为已完成。功能已构建并测试、但尚未获批时，请使用待批准标记。

下一步

Studio 连接后，开始处理当前任务——代码任务通常使用 roblox-luau-architecture，UI 任务通常使用 roblox-ui-implementation，Bug 任务通常使用 roblox-debugging-bugfix。如果不确定要处理什么，请使用 roblox-game-development-lifecycle。