@weppy/roblox-mcp 2.5.0 → 2.6.0

package/docs/ja/tools/assets-and-effects.md

@@ -1,104 +0,0 @@
-# アセット & オブジェクト演出
-
-> アセット挿入、トゥイーン、音、パーティクル、アニメーション、衝突グループを管理します。
-
-## 含まれるツール
-
-| ツール | ティア | 説明 |
-|--------|:------:|------|
-| `manage_assets` | Pro | Creator Store検索、モデル/パッケージ挿入、アセット情報確認 |
-| `manage_tween` | Pro | トゥイーン作成、再生、一時停止、キャンセル |
-| `manage_animation` | Pro | アニメーション読み込み、再生、停止、トラック確認 |
-| `manage_audio` | Pro | サウンド再生、停止、一時停止、再開、リスナー設定 |
-| `manage_effects` | Pro | パーティクル放出、クリア、効果切替 |
-| `manage_physics` | Pro | 衝突グループ登録と衝突設定 |
-
-## 主なワークフロー
-
-### アセットでシーンを作る
-
-```
-"Creator Store で木のモデルを検索して、Workspace に3つ配置して。"
-```
-
-`manage_assets.search_insert` を使うと、検索と挿入を一度に実行できます。
-
-### インタラクティブ演出を作る
-
-```
-"クリックしたらドアが3秒かけて開くトゥイーンを作って。"
-```
-
-`manage_tween.create` で動きを定義し、`manage_tween.play` で再生します。必要なら `manage_audio.play` で効果音を追加します。
-
-### パーティクルと音を組み合わせる
-
-```
-"ボス出現時に爆発音を鳴らして、同時にバーストパーティクルを出して。"
-```
-
-`manage_effects.emit` でパーティクルを放出し、`manage_audio.play` で音を再生します。
-
-## アクションリファレンス
-
-### Manage Assets（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `insert` | アセットIDでモデルを挿入 | Pro |
-| `info` | アセットメタデータを取得 | Pro |
-| `search` | Creator Storeを検索 | Pro |
-| `search_insert` | 検索して最初の一致を挿入 | Pro |
-| `insert_free` | 無料モデルを挿入 | Pro |
-| `insert_package` | パッケージを挿入 | Pro |
-| `export` | 現在の選択をエクスポート | Pro |
-
-### Manage Tween（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `create` | ターゲットプロパティ付きトゥイーンを作成 | Pro |
-| `play` | 作成したトゥイーンを再生 | Pro |
-| `pause` | 実行中のトゥイーンを一時停止 | Pro |
-| `cancel` | トゥイーンをキャンセル | Pro |
-
-### Manage Animation（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `load` | Humanoid または AnimationController にアニメーションをロード | Pro |
-| `play` | ロード済みアニメーショントラックを再生 | Pro |
-| `stop` | 再生中のアニメーションを停止 | Pro |
-| `get_tracks` | ロード済みアニメーショントラックを一覧 | Pro |
-
-### Manage Audio（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `play` | サウンドを再生（必要なら `Sound` を作成） | Pro |
-| `stop` | 再生中のサウンドを停止 | Pro |
-| `pause` | 再生中のサウンドを一時停止 | Pro |
-| `resume` | 一時停止したサウンドを再開 | Pro |
-| `set_listener` | オーディオリスナーの種類または対象を設定 | Pro |
-
-### Manage Effects（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `emit` | `ParticleEmitter` からパーティクルを放出 | Pro |
-| `clear` | すべてのパーティクルをクリア | Pro |
-| `toggle` | 効果を有効化または無効化 | Pro |
-
-### Manage Physics（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `register_group` | 衝突グループを登録 | Pro |
-| `set_collidable` | 2つのグループが衝突可能か設定 | Pro |
-| `get_groups` | 登録済み衝突グループを一覧 | Pro |
-
-## 関連ドキュメント
-
-- [インスタンス & プロパティ](instances-and-properties.md) - オブジェクト作成と配置
-- [ワールド環境](world-and-environment.md) - ライティング、Terrain、カメラ
-- [Tool一覧](overview.md)

package/docs/ja/tools/instances-and-properties.md

@@ -1,104 +0,0 @@
-# インスタンス & プロパティ
-
-> Roblox Studioのインスタンスを検索、作成、編集し、プロパティ、アトリビュート、タグを管理します。
-
-## 含まれるツール
-
-| ツール | ティア | 説明 |
-|--------|:------:|------|
-| `query_instances` | 混合 | インスタンス検索、階層探索、クラス情報確認 |
-| `mutate_instances` | 混合 | インスタンス作成、削除、複製、移動、名前変更 |
-| `manage_properties` | 混合 | プロパティ、アトリビュート、タグの読み書き |
-
-## 主なワークフロー
-
-### シーン構造を把握する
-
-```
-"Workspace配下のすべてのPartを検索して、位置とサイズを教えて。"
-```
-
-`query_instances.search_class` で Part を探し、`manage_properties.mass_get` で `Position` と `Size` を一括取得します。
-
-### オブジェクトをまとめて配置する
-
-```
-"マップ中央に SpawnLocation を4つ正方形に配置して、それぞれ別の TeamColor を設定して。"
-```
-
-`mutate_instances.mass_create` でまとめて作成し、`manage_properties.mass_set` でプロパティを一括設定します。
-
-### タグでまとめて管理する
-
-```
-"Collectible タグが付いたオブジェクトを全部探して Anchored を true にして。"
-```
-
-`manage_properties.get_tagged` で対象を集め、`manage_properties.mass_set` でまとめて更新します。
-
-## アクションリファレンス
-
-### Query Instances（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | パスでインスタンスプロパティを取得 | Basic |
-| `children` | 直接の子または全子孫を取得 | Basic |
-| `find_child` | 名前とオプションのクラスフィルタで最初の子を検索 | Basic |
-| `find_descendant` | 名前で最初の子孫を検索 | Basic |
-| `wait_for_child` | 子が表示されるまで待機（タイムアウト付き） | Basic |
-| `class_info` | クラス情報と有効なプロパティを取得 | Basic |
-| `search_name` | 名前パターンでインスタンスを検索（ワイルドカード対応） | Basic |
-| `search_class` | クラス名でインスタンスを検索 | Basic |
-| `file_tree` | ルートからファイルツリー構造を取得 | Pro |
-| `project_structure` | プロジェクト全体構造を取得 | Pro |
-| `descendants` | インスタンスの全子孫を取得 | Pro |
-| `ancestors` | インスタンスの全祖先を取得 | Pro |
-| `search_property` | プロパティ値でインスタンスを検索 | Pro |
-| `search_tag` | タグでインスタンスを検索 | Pro |
-
-### Mutate Instances（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `create` | 新しいインスタンスを作成 | Basic |
-| `create_with_props` | 初期プロパティ付きでインスタンスを作成 | Basic |
-| `delete` | インスタンスを削除 | Basic |
-| `clone` | インスタンスを複製 | Basic |
-| `move` | インスタンスを新しい親に移動 | Basic |
-| `rename` | インスタンスの名前を変更 | Basic |
-| `pivot` | ピボット位置またはCFrameを設定 | Basic |
-| `create_tree` | 階層的インスタンスツリーを作成 | Pro |
-| `mass_create` | 複数のインスタンスを一括作成 | Pro |
-| `mass_delete` | 複数のインスタンスを削除 | Pro |
-| `mass_duplicate` | 複数のインスタンスを複製 | Pro |
-| `smart_duplicate` | 間隔と個数を指定して複製 | Pro |
-
-### Manage Properties（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | 単一プロパティ値を取得 | Basic |
-| `set` | 単一プロパティ値を設定 | Basic |
-| `get_all` | インスタンスの全プロパティを取得 | Basic |
-| `set_multiple` | 複数プロパティを一括設定 | Basic |
-| `get_attr` | アトリビュート値を取得 | Basic |
-| `set_attr` | アトリビュート値を設定 | Basic |
-| `get_all_attrs` | 全アトリビュートを取得 | Basic |
-| `delete_attr` | アトリビュートを削除 | Basic |
-| `add_tag` | インスタンスにタグを追加 | Basic |
-| `remove_tag` | インスタンスからタグを削除 | Basic |
-| `check_tag` | インスタンスがタグを持っているか確認 | Basic |
-| `get_tags` | インスタンスの全タグを取得 | Basic |
-| `get_tagged` | 特定タグを持つ全インスタンスを取得 | Basic |
-| `set_calculated` | 数式を使ってプロパティを設定 | Pro |
-| `set_relative` | 現在値を基準に相対的にプロパティを設定 | Pro |
-| `mass_set` | 複数インスタンスにプロパティを設定 | Pro |
-| `mass_get` | 複数インスタンスからプロパティを取得 | Pro |
-| `modify_children` | 親の全子を修正 | Pro |
-
-## 関連ドキュメント
-
-- [スクリプト & コード実行](scripting.md) - インスタンス上のスクリプトを追加、修正
-- [アセット & オブジェクト演出](assets-and-effects.md) - モデル挿入、トゥイーン、エフェクト
-- [Tool一覧](overview.md)

package/docs/ja/tools/overview.md

@@ -1,277 +0,0 @@
-# Roblox MCPツール
-
-MCPツールの詳細パラメータはMCPツール定義を直接確認してください。
-
-## 機能別ガイド
-
-ワークフロー中心の詳細ガイドを参考にしてください。
-
-| カテゴリ | 説明 | 含まれるツール |
-|----------|------|----------------|
-| [インスタンス & プロパティ](instances-and-properties.md) | インスタンス検索、作成、編集、タグ管理 | `query_instances`, `mutate_instances`, `manage_properties` |
-| [スクリプト & コード実行](scripting.md) | スクリプト管理、Luau実行 | `manage_scripts`, `execute_luau` |
-| [ワールド環境](world-and-environment.md) | ライティング、Terrain、空間クエリ、カメラ | `manage_lighting`, `manage_terrain`, `spatial_query`, `manage_camera` |
-| [アセット & オブジェクト演出](assets-and-effects.md) | アセット挿入、トゥイーン、アニメーション、音、エフェクト | `manage_assets`, `manage_tween`, `manage_animation`, `manage_audio`, `manage_effects`, `manage_physics` |
-| [プレイテスト & 自動テスト](playtest.md) | プレイテスト制御と自動検証 | `system_info` (`play`, `stop`, `pause`, `resume`, `play_status`, `run_test`) |
-| [Sync](../sync/overview.md) | Studio とローカルファイルの同期 | `manage_sync`, `workspace_state` |
-| [システム & デバッグ](system-and-debugging.md) | 接続確認、ログ、選択、バッチ実行 | `system_info` (`ping`, `connection`, `usage`, ...), `manage_logs`, `manage_selection`, `batch_execute` |
-
-関連ドキュメント:
-- [Sync機能詳細ガイド](../sync/overview.md)
-
-Syncポリシー:
-- Basic: Studio -> Local 片方向同期
-- Pro: 双方向同期 + より広い高度アクション範囲（バルク操作でAIトークン効率向上）
-
-## Query Instances（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | パスでインスタンスプロパティを取得 | Basic |
-| `children` | 直接の子または全子孫を取得 | Basic |
-| `find_child` | 名前とオプションのクラスフィルタで最初の子を検索 | Basic |
-| `find_descendant` | 名前で最初の子孫を検索 | Basic |
-| `wait_for_child` | 子が表示されるまで待機（タイムアウト付き） | Basic |
-| `class_info` | クラス情報と有効なプロパティを取得 | Basic |
-| `search_name` | 名前パターンでインスタンスを検索（ワイルドカード対応） | Basic |
-| `search_class` | クラス名でインスタンスを検索 | Basic |
-| `file_tree` | ルートからファイルツリー構造を取得 | Pro |
-| `project_structure` | プロジェクト全体構造を取得 | Pro |
-| `descendants` | インスタンスの全子孫を取得 | Pro |
-| `ancestors` | インスタンスの全祖先を取得 | Pro |
-| `search_property` | プロパティ値でインスタンスを検索 | Pro |
-| `search_tag` | タグでインスタンスを検索 | Pro |
-
-## Mutate Instances（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `create` | 新しいインスタンスを作成 | Basic |
-| `create_with_props` | 初期プロパティ付きでインスタンスを作成 | Basic |
-| `delete` | インスタンスを削除 | Basic |
-| `clone` | インスタンスを複製 | Basic |
-| `move` | インスタンスを新しい親に移動 | Basic |
-| `rename` | インスタンスの名前を変更 | Basic |
-| `pivot` | ピボット位置またはCFrameを設定 | Basic |
-| `create_tree` | 階層的インスタンスツリーを作成 | Pro |
-| `mass_create` | 複数のインスタンスを一括作成 | Pro |
-| `mass_delete` | 複数のインスタンスを削除 | Pro |
-| `mass_duplicate` | 複数のインスタンスを複製 | Pro |
-| `smart_duplicate` | 間隔と個数を指定して複製 | Pro |
-
-## Manage Properties（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | 単一プロパティ値を取得 | Basic |
-| `set` | 単一プロパティ値を設定 | Basic |
-| `get_all` | インスタンスの全プロパティを取得 | Basic |
-| `set_multiple` | 複数プロパティを一括設定 | Basic |
-| `get_attr` | アトリビュート値を取得 | Basic |
-| `set_attr` | アトリビュート値を設定 | Basic |
-| `get_all_attrs` | 全アトリビュートを取得 | Basic |
-| `delete_attr` | アトリビュートを削除 | Basic |
-| `add_tag` | インスタンスにタグを追加 | Basic |
-| `remove_tag` | インスタンスからタグを削除 | Basic |
-| `check_tag` | インスタンスがタグを持っているか確認 | Basic |
-| `get_tags` | インスタンスの全タグを取得 | Basic |
-| `get_tagged` | 特定タグを持つ全インスタンスを取得 | Basic |
-| `set_calculated` | 数式を使ってプロパティを設定 | Pro |
-| `set_relative` | 現在値を基準に相対的にプロパティを設定 | Pro |
-| `mass_set` | 複数インスタンスにプロパティを設定 | Pro |
-| `mass_get` | 複数インスタンスからプロパティを取得 | Pro |
-| `modify_children` | 親の全子を修正 | Pro |
-
-## Manage Scripts（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get_source` | スクリプトソースコードを取得 | Basic |
-| `set_source` | スクリプトソースコードを設定 | Basic |
-| `create` | 新しいスクリプトを作成 | Basic |
-| `delete` | スクリプトを削除 | Basic |
-| `edit_replace` | スクリプトの特定行を置換 | Basic |
-| `edit_insert` | 特定位置に行を挿入 | Basic |
-| `edit_delete` | 特定行を削除 | Basic |
-| `search` | スクリプト内でテキストを検索 | Basic |
-| `get_dependencies` | スクリプトの依存関係を取得 | Basic |
-| `replace` | 複数スクリプトで一括置換 | Pro |
-
-## Manage Lighting（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `lighting` | Lightingサービスプロパティを設定 | Pro |
-| `atmosphere` | Atmosphereプロパティを設定 | Pro |
-| `sky` | Skyプロパティを設定 | Pro |
-| `terrain_props` | Terrain水/視覚プロパティを設定 | Pro |
-| `time` | 時間帯を設定 | Pro |
-
-## Manage Selection（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | 現在の選択を取得 | Basic |
-| `set` | 現在の選択を置換 | Basic |
-| `clear` | 選択をクリア | Basic |
-| `cached` | ラウンドトリップなしでキャッシュされた選択を取得 | Basic |
-| `context` | ソースとプロパティを含む詳細コンテキストを取得 | Pro |
-| `details` | 祖先/子孫を含む階層的詳細を取得 | Pro |
-| `add` | 選択にアイテムを追加 | Pro |
-| `remove` | 選択からアイテムを削除 | Pro |
-| `watch` | 選択変更を監視 | Pro |
-
-## Manage Camera（Basic）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `info` | カメラ位置、回転、FOV、ビューポートサイズを取得 | Basic |
-| `focus_path` | カメラをインスタンスにフォーカス移動 | Basic |
-| `focus_position` | カメラを位置にフォーカス移動 | Basic |
-| `suggest` | ターゲットの推奨カメラビューを取得 | Basic |
-
-## Manage Tween（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `create` | ターゲットプロパティ付きトゥイーンを作成 | Pro |
-| `play` | 作成したトゥイーンを再生 | Pro |
-| `pause` | 実行中のトゥイーンを一時停止 | Pro |
-| `cancel` | トゥイーンをキャンセル | Pro |
-
-## Manage Audio（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `play` | サウンドを再生（必要に応じてSound作成） | Pro |
-| `stop` | 再生中のサウンドを停止 | Pro |
-| `pause` | 再生中のサウンドを一時停止 | Pro |
-| `resume` | 一時停止中のサウンドを再開 | Pro |
-| `set_listener` | オーディオリスナータイプ/ターゲットを設定 | Pro |
-
-## Manage Animation（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `load` | Humanoid/AnimationControllerにアニメーションをロード | Pro |
-| `play` | ロード済みアニメーショントラックを再生 | Pro |
-| `stop` | 再生中のアニメーションを停止 | Pro |
-| `get_tracks` | ロード済み全アニメーショントラックを一覧 | Pro |
-
-## Manage Physics（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `register_group` | 衝突グループを登録 | Pro |
-| `set_collidable` | 2つのグループが衝突可能か設定 | Pro |
-| `get_groups` | 登録済み全衝突グループを一覧 | Pro |
-
-## Manage Effects（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `emit` | ParticleEmitterからパーティクルを放出 | Pro |
-| `clear` | 全パーティクルをクリア | Pro |
-| `toggle` | エフェクトを有効化または無効化 | Pro |
-
-## Manage Terrain（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `fill_block` | ブロック形状の地形を塗りつぶし | Pro |
-| `fill_ball` | 球形状の地形を塗りつぶし | Pro |
-| `fill_cylinder` | 円柱形状の地形を塗りつぶし | Pro |
-| `fill_wedge` | くさび形状の地形を塗りつぶし | Pro |
-| `clear_region` | 領域の地形をクリア | Pro |
-| `clear_bounds` | 境界の地形をクリア | Pro |
-| `replace_material` | 領域のマテリアルを置換 | Pro |
-| `colors_get` | マテリアル色を取得 | Pro |
-| `colors_set` | マテリアル色を設定 | Pro |
-| `read_voxel` | 単一ボクセルデータを読み取り | Pro |
-| `read_voxels` | 一括ボクセルデータを読み取り | Pro |
-| `write_voxels` | 一括ボクセルデータを書き込み | Pro |
-| `generate` | 手続き型地形を生成 | Pro |
-| `smooth` | 地形を滑らかにする | Pro |
-
-## Spatial Query（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `raycast` | 単一レイを投射 | Pro |
-| `find_ground` | 地点下の地面位置を検出 | Pro |
-| `check_placement` | 配置が衝突なしか確認 | Pro |
-| `multi_raycast` | 複数レイを一括投射 | Pro |
-| `scan_area` | 領域のハイトマップを生成 | Pro |
-| `find_flat` | 建築用の平坦エリアを検索 | Pro |
-| `find_spawn` | 適切なスポーン位置を検索 | Pro |
-| `analyze_walkable` | 歩行可能グリッドを分析 | Pro |
-| `spatial_map` | 全BasePartの位置を取得 | Pro |
-| `find_space` | オブジェクト用の空きスペースを検索 | Pro |
-| `bounds` | インスタンスのバウンディングボックスを取得 | Pro |
-| `snap_grid` | 位置をグリッドにスナップ | Pro |
-| `collision` | AABB衝突を確認 | Pro |
-
-## Manage Assets（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `insert` | アセットIDでモデルを挿入 | Pro |
-| `info` | アセットメタデータを取得 | Pro |
-| `search` | Creator Storeを検索 | Pro |
-| `search_insert` | 検索して最初のマッチを挿入 | Pro |
-| `insert_free` | フリーモデルを挿入 | Pro |
-| `insert_package` | パッケージを挿入 | Pro |
-| `export` | 現在の選択をエクスポート | Pro |
-
-## Manage Sync（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `status_current_place` | 現在接続中のPlaceの同期状態を取得 | Pro |
-| `history` | 変更履歴を取得 | Pro |
-| `directions` | タイプ別同期方向を取得 | Pro |
-| `read_file` | 同期済みファイルを読み取り | Pro |
-| `write_file` | 同期済みファイルに書き込み | Pro |
-| `progress` | リアルタイム同期進捗と帯域幅を取得 | Pro |
-
-## Workspace State（Pro）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `sync` | 現在のWorkspace状態を取得 | Pro |
-| `snapshot` | 完全なインスタンスツリー構造を取得 | Pro |
-| `changes` | 最近の変更を取得 | Pro |
-| `viewport` | カメラとビューポート情報を取得 | Pro |
-
-## Manage Logs（Basic）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `get` | フィルタリングされたログを取得 | Basic |
-| `clear` | ログバッファをクリア | Basic |
-| `errors` | 最近のエラーのみ取得 | Basic |
-
-## System Info（混合）
-
-| アクション | 説明 | ティア |
-|------------|------|--------|
-| `ping` | 接続テスト | Basic |
-| `connection` | サーバー/プラグイン接続情報を取得 | Basic |
-| `usage` | 現在のティアを取得（basic/pro） | Basic |
-| `place_info` | Place ID、名前、クリエイターを取得 | Pro |
-| `services` | 全Robloxサービスを一覧 | Pro |
-| `studio_settings` | Studio設定を取得 | Pro |
-| `play` | Play(F5) または Run(F8) モードでプレイテスト開始 | Pro |
-| `stop` | 現在のプレイテストを停止 | Pro |
-| `pause` | Run モードのプレイテストを一時停止 | Pro |
-| `resume` | 一時停止した Run モードのプレイテストを再開 | Pro |
-| `play_status` | プレイテスト状態と利用可能な action を取得 | Pro |
-| `run_test` | 一時テストスクリプトを注入し、プレイテスト実行後にログ収集とローカルレポート作成 | Pro |
-
-## Batch Execute（Pro）
-
-複数のコマンドを単一バッチで実行します。各コマンドはツール名と引数を指定します。コマンドは順次実行され、エラー時の続行動作を選択できます。
-
-## Execute Luau（Pro）
-
-Roblox Studioサンドボックスで任意のLuauコードを実行します。ブロックされたサービス：HttpService、DataStoreService、MessagingService。CoreGui/CorePackagesにはアクセスできません。

package/docs/ja/tools/playtest.md

@@ -1,140 +0,0 @@
-# プレイテスト & 自動テスト
-
-> AIでStudioプレイテストを制御し、テストスクリプトを注入して自動実行、検証、レポート生成を行います。
-
-## 含まれるツール
-
-| ツール | ティア | 説明 |
-|--------|:------:|------|
-| `system_info` | Pro | `play`, `stop`, `pause`, `resume`, `play_status`, `run_test` アクション |
-
-> `ping`、`connection`、`usage` など `system_info` の他アクションは [システム & デバッグ](system-and-debugging.md) を参照してください。
-
-## 主なワークフロー
-
-### 手動でプレイテストを制御する
-
-```
-"Play モード（F5）でゲームを開始して。"
-"今のプレイテストを止めて。"
-```
-
-基本の流れは `play` -> `play_status` -> `stop` です。
-
-### 自動テストを実行する
-
-```
-"SpawnLocation が正しい位置にあるか確認するテストを書いて実行して。"
-```
-
-`run_test` はテストスクリプトを注入し、プレイテストを自動開始し、ログ収集と後片付けまで行います。
-
-### CI風の検証
-
-```
-"Run モード（F8）で NPC が目標地点まで移動するかテストして、失敗したらログを見せて。"
-```
-
-サーバー中心の検証には `mode: "run"` を使って `run_test` を実行します。
-
-## プレイテスト状態マシン
-
-```text
-Edit --play--> Running --stop--> Edit
-                  |               ^
-                pause             |
-                  |               |
-                  v               |
-               Paused --resume--> Running
-```
-
-| 状態 | 利用可能アクション |
-|------|--------------------|
-| `edit` | `play` |
-| `running` | `stop`, `pause`（Runモードのみ） |
-| `paused` | `resume`, `stop` |
-
-- Playモード（F5）: クライアント + サーバーのシミュレーション、一時停止と再開は不可
-- Runモード（F8）: サーバー専用シミュレーション、一時停止と再開に対応
-
-## `run_test` パイプライン
-
-`run_test` は次の手順を自動オーケストレーションします。
-
-### 1. 準備
-
-- `place_info` で Place 情報を取得
-- 既存ログバッファをクリア
-
-### 2. スクリプト注入
-
-- `ServerScriptService.__MCP_TestRunner` にラップ済みテストスクリプトを作成
-- ラッパーが `START` / `FINISHED` シグナルとエラートレースバックを処理
-
-### 3. 実行と監視
-
-- Play または Run モードでプレイテスト開始
-- 500ms ごとにログをポーリング
-- `[WEPPY_TEST]:FINISHED` 検出で完了判定
-- タイムアウト時は自動停止（デフォルト60秒、最大300秒）
-
-### 4. 後片付け
-
-- プレイテスト自動停止
-- 注入したテストスクリプトを削除
-- 最終ログを回収
-
-### 5. レポート出力
-
-レポートとログはローカルの `{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/` 配下に保存されます。
-
-```text
-{projectRoot}/weppy-project-sync/place_XXXXX/tests/YYYYMMDD-HHmmss/
-├── test-report.md
-└── test-log.txt
-```
-
-`test-report.md` の例:
-
-```markdown
-# Test Report
-
-- Status: passed
-- Test Name: spawn_location_test
-- Mode: run
-- Place ID: 123456
-- Duration (ms): 1523
-- Total Logs: 12
-- Signal Count: 2
-
-## Signals
-
-- START: 2026-03-12T10:30:00.000Z
-- FINISHED: 2026-03-12T10:30:01.523Z
-```
-
-## アクションリファレンス
-
-| アクション | 説明 | パラメータ | ティア |
-|------------|------|------------|--------|
-| `play` | Play（F5）または Run（F8）モードでプレイテスト開始 | `mode`: `"play"` \| `"run"` | Pro |
-| `stop` | 現在のプレイテストを停止 | - | Pro |
-| `pause` | Runモードのプレイテストを一時停止 | - | Pro |
-| `resume` | 一時停止したRunモードのプレイテストを再開 | - | Pro |
-| `play_status` | プレイテスト状態と利用可能アクションを取得 | - | Pro |
-| `run_test` | テストスクリプト注入、実行、ログ収集、レポート生成 | `script`（必須）, `test_name`, `mode`, `timeout` | Pro |
-
-### `run_test` パラメータ
-
-| パラメータ | 型 | 必須 | 説明 |
-|------------|----|:----:|------|
-| `script` | string | ✅ | 実行するLuauテストコード本体 |
-| `test_name` | string | - | レポートに表示するテスト名 |
-| `mode` | `"play"` \| `"run"` | - | プレイテストモード。デフォルトは `"play"` |
-| `timeout` | number | - | タイムアウト秒。デフォルト60、最大300 |
-
-## 関連ドキュメント
-
-- [システム & デバッグ](system-and-debugging.md) - 接続系アクションとログ管理
-- [スクリプト & コード実行](scripting.md) - スクリプト作成とLuau実行
-- [Tool一覧](overview.md)