该技能用于通过 Roblox Studio MCP 调试和修复 Roblox 缺陷,目标是从症状走到经过验证的修复,而非猜测。核心纪律是先构建快速、可重复、确定性的复现循环:可用 Play 模式复现步骤并观察 get_console_output、用 execute_luau 直接调用可疑的服务端或模块函数并断言结果、构造触发目标代码路径的最小场景,或重放捕获的远程负载/数据。对间歇性缺陷,目标是提高复现率而非一次性干净复现。若确实无法建立循环,应停止并说明尝试过什么,向用户请求环境、日志、录屏或数据,或请求添加临时插桩的许可。
调试循环:捕获用户可见症状与预期行为;尽量在 Play 模式复现;读取 get_console_output;用 script_grep 与 script_search 搜索脚本;用 script_read 阅读相关脚本;用 search_game_tree 与 inspect_instance 检查实例;用 multi_edit 做最小安全修复;重新运行复现并再次检查控制台;最后用 script_grep 搜索前缀移除所有 [DEBUG-...] 临时插桩。
插桩阶段每条探针对应一个假设,一次只改一个变量,优先检查真实值而非刷日志;临时日志使用 [DEBUG-a4f2] 之类唯一前缀便于一次清理;性能回归应先用 os.clock、MicroProfiler、实例计数测量并二分。修复规则:优先根因修复而非防御性静默;不吞掉错误除非记录上下文;在信任边界附近添加验证;不把无关重构混入缺陷修复;确认没有新增控制台错误。
输出包括:复现、根因(说明哪个假设被证实)、变更的文件/脚本、执行的验证、遗留风险,以及事后复盘(什么本可防止该缺陷);若答案属于架构问题,在修复完成后建议转向 roblox-code-maintenance-refactor 或 roblox-luau-architecture。后续可用 roblox-playtest-qa 验证修复是否保持,涉及 UI/移动端时用 roblox-mobile-playtest。常见缺陷类别涵盖客户端/服务端状态不一致、远程负载信任问题、服务端状态变更后 UI 不更新、事件连接重复或未断开、DataStore 加载/保存竞态、对象路径改名或缺失等。