用途
roblox-debug 用于诊断 Roblox 或 Luau 代码中的错误、崩溃或意外行为。当需要排查此类问题时加载该技能，它会提供一个结构化的 7 步迭代调试循环，最多迭代 5 次，之后升级处理。该技能在文件同步模式和 MCP 模式下均可工作。
主要能力
该技能的核心是一个 7 步调试循环，最多迭代 5 次：
-
错误收集：获取确切的错误消息、堆栈跟踪（脚本 + 行号）、触发条件（加入/操作/定时器）。如果可用，使用 MCP 获取控制台输出。
-
代码发现：阅读相关脚本。根据堆栈跟踪搜索错误文本、函数名或脚本。
-
根因分析：将问题分类为语法（缺少 end）、运行时（nil、已销毁的 Instance）、逻辑（错误计算/条件）、安全（客户端逻辑）、性能（超时、内存）。加载 roblox-sharp-edges 以了解已知陷阱。找到确切行和真正的根因。
-
生成修复：生成修正后的 Luau 代码。解释哪里错了、为什么修复有效、需要检查的相关代码。标记架构变更。
-
应用与测试：将修复写入文件。如果可用，使用 MCP 验证。在离线模式下：提供前后差异对比和手动测试说明。MCP 证据：发现/选择 Studio，编辑前检查，回读修复，在相关时运行 playtest，并明确报告控制台/截图的限制。
-
验证：已解决 → 进入第 7 步。出现新错误 → 返回第 1 步。相同错误 → 提出新假设，返回第 3 步。第 5 次迭代 → 携带完整诊断升级。
-
总结：记录：错误描述、根因、应用的修复、验证、相关风险、预防模式。如果是系统性问题，建议 /code-review。
使用方式
在诊断 Roblox/Luau 代码中的错误、崩溃或意外行为时加载该技能。它支持文件同步和 MCP 两种模式。在 MCP 模式下，可以获取控制台输出、验证修复、运行 playtest 等。在离线模式下，提供前后差异对比和手动测试说明。
升级机制
在第 5 次迭代时，输出：所有尝试过的修复及被拒绝的原因、剩余假设、推荐的下一步（手动调查、DevForum 搜索等）。
适用场景
适用于诊断 Roblox 或 Luau 代码中的错误、崩溃或意外行为。
限制
最多迭代 5 次，之后升级处理。MCP 模式下存在控制台/截图等限制，需明确报告。