关于 roblox-debug
roblox-debug 是用于诊断 Roblox/Luau 错误、崩溃和异常行为的调试技能，面向 Roblox 开发者。它提供最多迭代 5 次的七步排查流程，并涵盖文件同步和 MCP 模式。
主要功能
- 01按七步流程迭代调试
- 02分类分析错误根因
- 03生成并应用 Luau 修复
- 04通过 MCP 验证修复（可用时）
- 05最多五轮后升级处理
适用场景
- 01定位 Roblox 脚本错误和堆栈问题
- 02排查运行时、逻辑或性能异常
- 03在 Studio 中检查并测试修复
- 04整理尝试过的方案并升级复杂问题
MCP 相关
在 MCP 模式下，可发现并选择 Studio、检查代码、读取修复结果，并在相关情况下运行 playtest。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/roblox-debug确认已加载。
附带文件references/full.md
详细介绍
何时加载
在诊断 Roblox/Luau 代码中的错误、崩溃或意外行为时加载。提供一个结构化的 7 步迭代调试循环，最多迭代 5 次，之后升级处理。适用于文件同步模式和 MCP 模式。
快速参考
7 步调试循环（最多迭代 5 次）
1. 收集错误信息 — 获取准确的错误消息、堆栈跟踪（脚本 + 行号）和触发条件（加入游戏／操作／计时器）。如果可用，使用 MCP 获取控制台输出。
2. 查找代码 — 阅读相关脚本。搜索错误文本、函数名称或堆栈跟踪中的脚本。
3. 分析根本原因 — 分类：语法错误（缺少 end）· 运行时错误（nil、已销毁的 Instance）· 逻辑错误（计算／条件错误）· 安全问题（客户端逻辑）· 性能问题（超时、内存）。加载 roblox-sharp-edges，了解已知易错点。找出确切行号和真正的根本原因。
4. 生成修复方案 — 提供修正后的 Luau。解释哪里出错、修复为何有效，以及需要检查的相关代码。标记架构变更。
5. 应用并测试 — 将修复写入文件。如果可用，使用 MCP 验证。离线模式下：提供修改前后的差异和手动测试说明。
**MCP 证据：**发现／选择 Studio、编辑前检查、读回修复内容、在适用时运行游戏测试，并明确说明控制台／屏幕截图方面的限制。
6. 验证 — 问题已解决 → 转至第 7 步。出现新错误 → 返回第 1 步。仍是同一错误 → 提出新假设，返回第 3 步。第 5 次迭代 → 提供完整诊断并升级处理。
7. 总结 — 记录：错误描述 · 根本原因 · 已应用的修复 · 验证结果 · 相关风险 · 预防模式。如果问题具有系统性，建议使用 /code-review。
升级处理（第 5 次迭代时）
输出：所有尝试过的修复及其被否决的原因、尚存的假设、建议的后续步骤（手动调查、搜索 DevForum 等）。
📖 完整参考：references/full.md