@amazon-devices/amazon-devices-buildertools-mcp 0.1.31 → 0.1.33

package/README.ja.md

@@ -4,10 +4,6 @@
 
 Model Context Protocol (MCP) サーバーで、AIエージェントがAmazonの[Vega OS](https://developer.amazon.com/apps-and-games/vega)向けアプリの開発とデバッグを行うためのコンテキストとツールを提供します。
 
-## 移行のお知らせ
-
-> **重要**: このMCPサーバーは `@amazon-devices/vega-devtools-mcp` から `@amazon-devices/amazon-devices-buildertools-mcp` に名称変更されました。以前のバージョンをインストールしている場合は、MCPの設定を更新して `@amazon-devices/vega-devtools-mcp` を削除し、`@amazon-devices/amazon-devices-buildertools-mcp` サーバーを使用して最新のアップデートと機能を受け取ってください。
-
 ## 機能
 
 Amazon Devices Builder Tools MCPは以下の機能をサポートしています：
@@ -25,9 +21,9 @@ Amazon Devices Builder Tools MCPは以下の機能をサポートしています
 | **キー入力レイテンシー**          | JSスレッドパフォーマンスと入力イベント分析によるキー入力レイテンシーの問題を診断・解決 | <ul><li>`なぜアプリのキー入力が遅いのですか？`</li><li>`Vegaアプリのキー入力レイテンシーを診断してください`</li><li>`ボタンクリックが遅く感じます、助けてください`</li></ul>                                                                                                                                                 |
 | **UI流暢性**                | コンポーネント再レンダリングとCPUパフォーマンス分析によるUI流暢性KPI障害の診断    | <ul><li>`アプリのUI流暢性スコアが低いです、診断してください`</li><li>`Vegaアプリのフレームドロップとジャンクを修正してください`</li><li>`アプリのスクロールがスムーズでないのはなぜですか？`</li></ul>                                                                                                                                                |
 | **アプリ移植** *(ベータ)*       | アプリタイプの自動検出によるFireOSアプリのVegaへの移植、またはWeb URLをVega WebViewアプリとしてラップ。4つの入力パスをサポート：FOS WebView → Vega WebView、FOS React Native → VegaScript、FOS Native (Java/Kotlin) → VegaScript *(部分的サポート)*、Web URL → Vega WebView。 | <ul><li>`TVアプリをVegaに移植してください`</li><li>`/path/to/fos-appにあるFireOSアプリをVegaに移行してください`</li><li>`FOS React NativeアプリをVegaScriptに移植してください`</li><li>`FOS WebViewアプリをVega Webアプリに変換してください`</li><li>`https://example.com をVega WebViewアプリとしてラップしてください`</li></ul> |
-| **RNアップグレード** *(アルファ)*       | AI支援による移行でVegaScriptアプリのReact Nativeバージョンをアップグレード。包括的なアップグレードガイド、破壊的変更の分析、バージョンアップグレード（例：RN 0.72 → 0.83）のためのインタラクティブなTODOベースのワークフローを提供。 | <ul><li>`VegaアプリをReact Native 0.72から0.83にアップグレードしてください`</li><li>`RN 0.83にアップグレードする際の破壊的変更は何ですか？`</li><li>`React Nativeアップグレードプロセスをガイドしてください`</li></ul> |
 | **Appstore IAP統合**   | VegaアプリでAmazon Appstoreアプリ内課金（IAP）SDKを統合・テスト                      | <ul><li>`VegaアプリにIAPを統合してください`</li><li>`Vegaアプリのアプリ内課金をセットアップするにはどうすればよいですか？`</li><li>`VegaアプリでIAPをテストしてください`</li></ul>                                                                                                                                                                      |
-| **フィードバックの提供** | MCPの使用体験についてAmazonにフィードバックを提供 | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul> |
+| **フィードバックの提供**       | MCPの使用体験についてAmazonにフィードバックを提供                                                | <ul><li>`フィードバックを提供したい`</li><li>`Vega MCPのフィードバックを提供するにはどうすればよいですか？`</li></ul>                                                                                                                                                                                                                  |
+| **リモートナレッジ検索**       | developer.amazon.comおよびcommunity.amazondeveloper.comからドキュメントを検索・取得し、ローカルワークフロー以外のアプリ開発トピックについてもAIアシスタンスを提供 | <ul><li>`Vegaアプリのベータテストはどうすればできますか？`</li><li>`Vegaアプリのアクセシビリティガイドラインは何ですか？`</li><li>`Amazon Appstoreにアプリを提出するにはどうすればよいですか？`</li><li>`VegaのDRMオプションは何がありますか？`</li></ul>                                                                                    |
 
 ## ワンクリックインストール
 
@@ -116,10 +112,10 @@ npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --hel
 ### インタラクティブモードのプロンプト
 
 インタラクティブモードで実行すると、以下のガイドが表示されます：
-# 1. AIエージェントを選択（例：Cursorの場合は「1」、Kiroの場合は「6」、その他/カスタムの場合は「8」）
-# 2. エージェントのMCP設定ファイルを自動的に更新するにはy/nを入力
-# 3. デフォルトのコンテキストドキュメントインストールパスを選択するか、カスタムパスを入力
-# 4. アクションを選択：マージ、更新、またはファイルを保存。続行する前にインストールされたコンテキストドキュメントを確認してください。
+1. AIエージェントを選択（例：Cursorの場合は「1」、Kiroの場合は「6」、その他/カスタムの場合は「8」）
+2. エージェントのMCP設定ファイルを自動的に更新するにはy/nを入力
+3. デフォルトのコンテキストドキュメントインストールパスを選択するか、カスタムパスを入力
+4. アクションを選択：マージ、更新、またはファイルを保存。続行する前にインストールされたコンテキストドキュメントを確認してください。
 
 ### 他のAIエージェントでの使用
 
@@ -228,45 +224,18 @@ Amazon Devices Builder Tools MCPが提供するツールをリストしてくだ
 以下のツールを含む応答が表示されるはずです：
 
 - analyze_perfetto_traces
-- read_document
+- get_app_hot_functions
 - list_documents
-- diagnose_crash
-- diagnose_key_input_latency
-- diagnose_ui_fluidity
+- read_asset
+- read_document
+- search_documentation
+- symbolicate_acr
 
 ## MCPツール
 
 Amazon Devices Builder Tools MCPは、Vegaアプリ開発を支援するために以下のツールを提供します：
 
-### 1. `read_document`
-
-Amazon Vega OSのアプリ開発に関連するドキュメントを読み取ります。このツールは、Vegaアプリ開発とデバッグトピックに関する包括的なドキュメントへのアクセスを提供します。
-
-**パラメータ:**
-- `document_name`（必須）: 読み取るドキュメントの名前（例：`react-native-for-vega-performance-best-practices.md`）。`.md`拡張子を持つマークダウンドキュメントである必要があります。
-
-**使用例:**
-```
-react-native-for-vega-performance-best-practices.mdドキュメントを読み取ってください
-```
-
-### 2. `list_documents`
-
-Amazon Vega OSのアプリ開発に関連する利用可能なすべてのVegaドキュメントをリストします。`read_document`ツールを使用して取得できる利用可能なドキュメントの名前と説明を返します。
-
-**パラメータ:**
-- `documentType`（オプション）: タイプでドキュメントをフィルタリング。有効な値：`KB`（ナレッジベース）、`PROMPT`、`STEERING`、`WORKFLOW`
-
-**使用例:**
-```
-利用可能なすべてのVegaドキュメントをリストしてください
-```
-または
-```
-タイプKBのドキュメントをリストしてください
-```
-
-### 3. `analyze_perfetto_traces`
+### 1. `analyze_perfetto_traces`
 
 Perfettoトレースプロセッサを使用してVegaプラットフォームトレースを分析し、KPIメトリックと関連するパフォーマンスデータを抽出します。このツールは、パフォーマンスの問題を診断し、アプリの起動時間を分析するのに役立ちます。
 
@@ -283,7 +252,7 @@ Perfettoトレースプロセッサを使用してVegaプラットフォーム
 /path/to/iter_1_vs_traceのトレースファイルを分析してください
 ```
 
-### 4. `get_app_hot_functions`
+### 2. `get_app_hot_functions`
 
 CPUトレースファイルを読み取って分析し、パフォーマンスのボトルネックに寄与するホット関数（CPU集約的な操作）を特定します。このツールは、アプリケーションのどの関数が最もCPU時間を消費しているかを特定し、ターゲットを絞ったパフォーマンス最適化を可能にします。
 
@@ -305,41 +274,82 @@ CPUトレースファイルを読み取って分析し、パフォーマンス
 /path/to/trace.jsonで5秒から15秒までのホット関数を20関数の制限で分析してください
 ```
 
-## MCPプロンプト
+### 3. `list_documents`
 
-> AIエージェントがhttps://modelcontextprotocol.io/clientsでMCPプロンプト（`/prompts`）をサポートしているか確認してください
+Amazon Vega OSのアプリ開発に関連する利用可能なすべてのVegaドキュメントをリストします。`read_document`ツールを使用して取得できる利用可能なドキュメントの名前と説明を返します。
 
-Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワンクリック実行できる一般的なワークフロー用の以下の事前定義されたプロンプトテンプレートを提供します：
+**パラメータ:**
+- `documentType`（オプション）: タイプでドキュメントをフィルタリング。有効な値：`KB`（ナレッジベース）、`PROMPT`、`STEERING`、`WORKFLOW`
 
-**重要**: Amazon Devices Builder Tools MCPが提供するプロンプトの完全なリストを表示するには、常にAIエージェントで`/prompts`を実行してください
+**使用例:**
+```
+利用可能なすべてのVegaドキュメントをリストしてください
+```
+または
+```
+タイプKBのドキュメントをリストしてください
+```
 
-### 1. `diagnose_kpi_ttff`
+### 4. `read_asset`
 
-**説明:** VegaアプリケーションのTime to First Frame（TTFF）KPIを診断
+Vegaドキュメントで参照されているアセットを読み取ります。アセットは一時的な場所に保存され、パスが返されます。
 
 **パラメータ:**
-- `kpi_report_file_path`（必須、文字列）: KPIレポートファイルへの絶対パス
-- `kpi_to_diagnose`（必須、文字列）: 診断するKPIレポートからのKPIの名前
+- `asset_id`（必須）: 読み取るアセットのパス（例：`assets/scripts/example.py`または`assets/images/diagram.png`）
 
 **使用例:**
 ```
-> @diagnose_kpi_ttff /path/to/report.json ttff
+assets/scripts/setup.shスクリプトを読み取って実行してください
 ```
 
-### 2. `diagnose_kpi_ttfd`
+### 5. `read_document`
 
-**説明:** VegaアプリケーションのTime to Fully Drawn（TTFD）KPIを診断
+Amazon Vega OSのアプリ開発に関連するドキュメントを読み取ります。このツールは、Vegaアプリ開発とデバッグトピックに関する包括的なドキュメントへのアクセスを提供します。
 
 **パラメータ:**
-- `kpi_report_file_path`（必須、文字列）: KPIレポートファイルへの絶対パス
-- `kpi_to_diagnose`（必須、文字列）: 診断するKPIレポートからのKPIの名前
+- `document_uri`（必須）: 読み取るドキュメントのURI。ローカルドキュメント名（例：`vega_cli_commands_reference.md`）またはdeveloper.amazon.comのURLを受け付けます。
 
 **使用例:**
 ```
-> @diagnose_kpi_ttfd /path/to/report.json ttfd
+react_native_for_vega_architecture.mdドキュメントを読み取ってください
 ```
 
-### 3. `apply_performance_best_practices`
+### 6. `search_documentation`
+
+全文検索を使用してVega開発ドキュメントを検索します。クエリに一致するドキュメントURIと関連するスニペットを返します。完全なコンテンツを取得するには、返されたURIで`read_document`を使用してください。
+
+**パラメータ:**
+- `query`（必須）: 関連するドキュメントを検索するための検索クエリ文字列
+
+**使用例:**
+```
+「パフォーマンス最適化」に関するドキュメントを検索してください
+```
+
+### 7. `symbolicate_acr`
+
+ACR（Amazon Crash Report）ファイルをシンボリケートしてレポートを作成します。GDBベースのネイティブクラッシュシンボリケーションとJavaScriptスタックトレースシンボリケーションの両方をサポートします。
+
+**パラメータ:**
+- `acrFilePath`（必須）: シンボリケートするACRファイルへのパス
+- `decodeMode`（必須）: ネイティブクラッシュの場合は`gdb`（`debugFsPath`または`deviceId`が必要）、JavaScriptスタックトレースの場合は`js`
+- `debugFsPath`（オプション）: デバッグルートFSへのパス。`gdb`モードで使用。
+- `deviceId`（オプション）: デバッグFSを取得するターゲットデバイスのシリアル番号。`gdb`モードで使用。
+
+**使用例:**
+```
+/path/to/crash.acrのクラッシュファイルをJSモードでシンボリケートしてください
+```
+
+## MCPプロンプト
+
+> AIエージェントがhttps://modelcontextprotocol.io/clientsでMCPプロンプト（`/prompts`）をサポートしているか確認してください
+
+Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワンクリック実行できる一般的なワークフロー用の以下の事前定義されたプロンプトテンプレートを提供します：
+
+**重要**: Amazon Devices Builder Tools MCPが提供するプロンプトの完全なリストを表示するには、常にAIエージェントで`/prompts`を実行してください
+
+### 1. `apply_performance_best_practices`
 
 **説明:** コンポーネントレンダリング、メモリ管理、ナビゲーション、ネットワーク最適化、状態管理を含むReact Nativeアプリケーションのパフォーマンスの問題を診断して最適化します。
 
@@ -351,7 +361,7 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
 > @apply_performance_best_practices /path/to/my-vega-app/src
 ```
 
-### 4. `detect_component_re-renders`
+### 2. `detect_component_re-renders`
 
 **説明:** React Nativeツールを使用して、コンポーネントの再レンダリングによって引き起こされるVegaアプリケーションのUI流動性パフォーマンスの問題を診断して最適化します。
 
@@ -363,40 +373,36 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
 > @detect_component_re-renders /path/to/my-vega-app
 ```
 
-### 5. `upgrade_carousel_component`
+### 3. `diagnose-slowAppLaunch`
 
-**説明:** Vega SDKのCarouselコンポーネントの新しいバージョンへの移行を支援します。
+**説明:** Vegaアプリケーションの遅いアプリ起動KPI（TTFFおよび/またはTTFD）を診断します。
 
 **パラメータ:**
-- `current_implementation_file_path`（必須、文字列）: CarouselのV1実装を含むファイルへの絶対パス
-- `current_version`（必須、文字列）: パッケージに依存しないCarouselの現在のバージョン
-- `target_version`（必須、文字列）: パッケージに依存しないCarouselのターゲットバージョン
+- `kpi_report_file_path`（必須、文字列）: KPIレポートファイルへの絶対パス
+- `kpi_to_diagnose`（必須、文字列）: 診断するKPIレポートからのKPIの名前
 
 **使用例:**
 ```
-> @upgrade_carousel_component /path/to/HomeScreen.tsx 1.0.6 2.0.0
+> @diagnose-slowAppLaunch /path/to/report.json ttff
 ```
 
-### 6. `diagnose_crash`
+### 4. `diagnose_crash`
 
 **説明:** JavaScript、Native、LMK（Low Memory Killer）、ANR（Application Not Responding）クラッシュを含むVegaアプリケーションのクラッシュを診断します。ACRファイルを自動検出し、スタックトレースをシンボリケートし、適切な分析ワークフローにルーティングします。
 
 **パラメータ:**
-
 - `acr_file_path`（任意、文字列）: ACRファイルへのパス。指定しない場合、デバイスの一時ディレクトリからACRファイルを自動検出します。
 
 **使用例:**
-
 ```
 > @diagnose_crash /path/to/crash.acr
 ```
 
-### 7. `diagnose_key_input_latency`
+### 5. `diagnose_key_input_latency`
 
 **説明:** JSスレッドパフォーマンス、CPUボトルネック、入力イベント処理の最適化を体系的に分析し、React Native Vegaアプリのキー入力レイテンシーの問題を診断・解決します。
 
 **パラメータ:**
-
 - `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
 - `app_process_name`（任意、文字列）: 入力レイテンシーが発生しているアプリプロセスの名前。指定しない場合、manifest.tomlから自動的に解決されます。
 - `perfetto_trace_file_path`（任意、文字列）: 既存のPerfettoトレースファイルへの絶対パス（既にキャプチャ済みの場合）
@@ -404,21 +410,68 @@ Amazon Devices Builder Tools MCPは、AIエージェントの`/prompts`でワン
 - `latency_threshold_ms`（任意、数値）: 許容される最大入力レイテンシー（ミリ秒）。デフォルトは100。
 
 **使用例:**
-
 ```
 > @diagnose_key_input_latency /path/to/my-vega-app
 ```
 
-### 8. `diagnose_ui_fluidity`
+### 6. `diagnose_ui_fluidity`
 
-**説明:** コンポーネント再レンダリングとCPUパフォーマンスボトルネックの体系的な分析を通じて、React Native VegaアプリのUI流暢性KPI障害を診断します。
+**説明:** コンポーネント再レンダリングとCPUパフォーマンスボトルネックの体系的な分析を通じて、React Native VegaアプリのUI流暢性KPI障害を包括的に診断します。
 
 **パラメータ:**
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
 
+**使用例:**
+```
+> @diagnose_ui_fluidity /path/to/my-vega-app
+```
+
+### 7. `fix_hot_functions`
+
+**説明:** CPU集約的なホット関数を分析・修正することで、VegaアプリケーションのUI流暢性の問題を診断・最適化します。
+
+**パラメータ:**
 - `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
 
 **使用例:**
+```
+> @fix_hot_functions /path/to/my-vega-app
+```
+
+### 8. `react_native_for_vega_add_simple_media_playback_implementation`
+
+**説明:** 既存のReact Native for Vegaアプリケーションにシンプルなメディア再生実装を追加します。
+
+**パラメータ:**
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
 
+**使用例:**
 ```
-> @diagnose_ui_fluidity /path/to/my-vega-app
+> @react_native_for_vega_add_simple_media_playback_implementation /path/to/my-vega-app
+```
+
+### 9. `react_native_for_vega_ai_assisted_rn_upgrade`
+
+**説明:** AI支援による移行でReact Nativeバージョンアップグレードのための汎用ターンベースワークフローをトリガーします。
+
+**パラメータ:**
+- `vega_app_package_path`（必須、文字列）: Vegaアプリパッケージのルートディレクトリへの絶対パス
+
+**使用例:**
+```
+> @react_native_for_vega_ai_assisted_rn_upgrade /path/to/my-vega-app
+```
+
+### 10. `upgrade_carousel_component`
+
+**説明:** Vega SDKのCarouselコンポーネントの新しいバージョンへの移行を支援します。
+
+**パラメータ:**
+- `current_implementation_file_path`（必須、文字列）: CarouselのV1実装を含むファイルへの絶対パス
+- `current_version`（必須、文字列）: パッケージに依存しないCarouselの現在のバージョン
+- `target_version`（必須、文字列）: パッケージに依存しないCarouselのターゲットバージョン
+
+**使用例:**
+```
+> @upgrade_carousel_component /path/to/HomeScreen.tsx 1.0.6 2.0.0
 ```