expo-observe について
EAS Observe の導入と本番パフォーマンスデータの確認を支援する、Expo 開発者向けスキルです。セットアップ、ナビゲーションやカスタムイベント、CLI クエリ、指標の解釈を扱います。
主な機能
- 01EAS Observe の導入
- 02起動とナビゲーション指標の追跡
- 03カスタムイベントの記録
- 04CLI によるパフォーマンスデータの照会
- 05指標と診断パターンの解釈
活用シーン
- 01Expo アプリの本番パフォーマンス監視を設定
- 02端末から指標、ルート、イベントを確認
- 03指標から起動遅延やメインスレッドの競合を特定
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ expo/ skills --skill expo-observeインストール後、Claude Code で/expo-observeを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/metrics.mdqueries.mdsetup.md詳細
EAS Observe
EAS Observe は、本番環境の Expo アプリで、起動、ナビゲーション、カスタムイベントのパフォーマンスを追跡します。
信頼できる唯一の情報源: https://docs.expo.dev/eas/observe/ — API の詳細が重要な場合、特に get-started、configuration、integrations、metrics reference については、必ず公式ドキュメントを確認してください。EAS Observe は進化を続けているため、このスキルのリファレンスは正確さを保つように記述されていますが、ドキュメントの内容に追いついていない場合があります。
参照先の選び方
./references/ にある3つのリファレンスファイルでは、このスキルで一般的に必要となる3つの内容を扱っています。
- プロジェクトへの EAS Observe の追加 →
./references/setup.md。インストール、ルートレイアウトのラップ(SDK 55 ではAppMetricsRoot、SDK 56 以降ではObserveRoot)、markInteractive()の呼び出し(SDK 55 ではグローバル、SDK 56 以降ではuseObserve()フック経由)、Expo Router/React Navigation とのインテグレーションによる任意のルート単位のナビゲーションメトリクス、Observe.logEventによるユーザー定義イベント(SDK 56 以降)を説明しています。 - ターミナルからのメトリクスのクエリ →
./references/queries.md。5つのeas observe:*コマンド(metrics-summary、metrics、routes、events、versions)について、フラグ、テーブルレイアウト、JSON の構造、一般的なワークフローを説明しています。 - ダッシュボードまたは CLI の出力の読み方 →
./references/metrics.md。各メトリクスの目標しきい値、TTI のframeRate.*パラメーターの意味、遅いながらもスムーズな起動と、メインスレッドの競合や完全なブロックを見分けるための診断パターンを説明しています。
ドキュメントへのクイックリンク
- はじめに:https://docs.expo.dev/eas/observe/get-started/
- ダッシュボードガイド:https://docs.expo.dev/eas/observe/dashboard/
- メトリクスリファレンス:https://docs.expo.dev/eas/observe/reference/metrics/
- Expo Router インテグレーション:https://docs.expo.dev/eas/observe/integrations/expo-router/
- React Navigation インテグレーション:https://docs.expo.dev/eas/observe/integrations/react-navigation/
- ユーザー定義イベント:https://docs.expo.dev/eas/observe/events/
- 設定:https://docs.expo.dev/eas/observe/configuration/
コメント
Markdown 対応