roblox-debug について
roblox-debug は、Roblox/Luau コードのエラー、クラッシュ、予期しない動作を調べるデバッグスキルです。Roblox 開発者向けに、ファイル同期モードまたは MCP モードで最大 5 回の 7 ステップ手順を案内します。
主な機能
- 017 ステップの反復デバッグ手順
- 02根本原因の分類と分析
- 03Luau の修正案の生成と適用
- 04可能な場合の MCP による修正検証
- 05最大 5 回の反復後にエスカレーション
活用シーン
- 01Roblox スクリプトのエラーやスタックを追跡
- 02実行時、ロジック、性能の問題を調査
- 03Studio で修正を確認してテスト
- 04試した修正を記録して難しい問題を引き継ぎ
MCP 対応
MCP モードでは Studio の検出と選択、コードの確認、修正内容の再読み込み、必要に応じたプレイテストを行えます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/roblox-debugを入力して読み込まれたか確認します。
同梱ファイルreferences/full.md
詳細
読み込むタイミング
Roblox/Luau コードのエラー、クラッシュ、予期しない動作を診断するときに読み込みます。最大 5 回の反復後にエスカレーションする、構造化された 7 ステップの反復デバッグループを提供します。ファイル同期モードと 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