mcpField
R
roblox-studio-workflow

roblox-studio-workflow

github.com/ashexplained開発44123 回インストール18 週間前に更新
リポジトリ

roblox-studio-workflow について

roblox-studio-workflowは、ローカルのStudioセッションでRoblox Studioの作業を進めるスキルです。コーディングエージェント向けに、確認、スクリプト編集、アセット処理、テストの手順を示します。

主な機能

  1. 01Studioセッションの開始
  2. 02スクリプトの検索・読み取り・編集
  3. 03ゲームツリーとインスタンスの確認
  4. 04アセット検索とインポート内容の確認
  5. 05ゲームとUIのプレイテスト

活用シーン

  1. 01Studioでスクリプトを読んでから編集
  2. 02ゲーム動作とコンソール出力の確認
  3. 03シーン変更前のオブジェクト確認
  4. 04サードパーティーアセットの使用前レビュー

MCP 対応

ローカルの`Roblox_Studio` MCPサーバーを使った作業を案内します。アクティブなStudioの選択から、ツールによる確認、編集、テストまでを扱います。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/ashexplained/roblox-skills --skill roblox-studio-workflow

インストール後、Claude Code で/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. place に 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 で既存のアセットを検索します。
  • サードパーティ製の Creator Store またはインベントリアセットは、最初に管理された場所へ insert_asset で挿入します。
  • サードパーティ製のモデル、パッケージ、ゲームプレイアセット、UI アセット、またはプラグインのようなアセットをインポートした後は、それを信頼したりスクリプトを有効にしたままにしたりする前に、roblox-creator-store-security-audit を実行します。
  • マーケットプレイスまたはインベントリのアセットが要件に合わない場合に限り、生成します。
    • カスタムメッシュを 1 つ作成するには generate_mesh を使用します。
    • 表面の外観を作成するには generate_material を使用します。
    • 設定可能なプリミティブ構成のモデルを作成するには generate_procedural_model を使用します。
  • ローカル画像またはウェブ画像を Roblox 対応アセットにする必要がある場合は、store_image または upload_image を使用します。

プレイテスト

  • 実際に動作を確認するには start_stop_play を使用します。
  • ゲームプレイと UI を操作するには character_navigation、user_keyboard_input、user_mouse_input を使用します。
  • 視覚的な状態を確認するには screen_capture を使用します。
  • プレイテストの後は必ず get_console_output を確認します。

ロードマップの運用

実装、テスト、人間による明示的な承認が完了した後にのみ、ロードマップの項目を完了済みにします。機能の実装とテストが完了していても、まだ承認されていない場合は、承認待ちのマーカーを使用します。

次の手順

Studio に接続したら、取り組むべきタスクに進みます。通常、コードには roblox-luau-architecture、UI には roblox-ui-implementation、バグには roblox-debugging-bugfix を使用します。何に取り組むべきか分からない場合は、roblox-game-development-lifecycle を使用します。

コメント

Markdown 対応