mcpField
F
flutter-product-analytics

flutter-product-analytics

github.com/thienqoデータ・データベース1775 回インストール4 日前に更新
リポジトリ

flutter-product-analytics について

Flutter 製品の分析計測を設計する開発者向けのスキルです。製品上の問いと安定したイベント契約を起点に、ID、同意、配信の意味、エンドツーエンド検証を扱い、運用監視との役割を分けます。

主な機能

  1. 01意味上のトリガーと安定したイベント契約の定義
  2. 02プロパティ、ID、同意ポリシーの指定
  3. 03重複送信の防止と再試行への対応
  4. 04オフラインキューと環境分離のテスト
  5. 05イベント受信と下流分析の検証

活用シーン

  1. 01製品判断に向けたイベントとファネルの設計
  2. 02ログイン、ログアウト、アカウント切り替え時のID管理
  3. 03同意状態に応じたオフラインイベント配信の検証

インストール

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

$npx skills add https://github.com/thienqo/flutter-skills --skill flutter-product-analytics

インストール後、Claude Code で/flutter-product-analyticsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
event-contracts-and-ownership.md
identity-consent-and-privacy.md
verification-and-experiments.md

詳細

Flutter プロダクト分析

ウィジェットではなく、意思決定を計測します。まずプロダクトに関する問いと安定したイベント契約を定め、移行を求められていない限り、プロジェクトの分析プロバイダー、同意プラットフォーム、状態管理、ナビゲーション、データアーキテクチャを維持します。

このスキルが選択されたという理由だけで、ベンダーを追加したり、ダッシュボードを作成したり、収集を有効にしたり、稼働中の保持設定や同意設定を変更したりしないでください。

事前確認

イベントを追加する前に、pubspec.yaml、SDK の制約、現在の分析アダプターと初期化処理、環境、同意とプライバシーの制御、イベント定義、ID のライフサイクル、ナビゲーションの追跡、オフラインバッファリング、バックエンドの変換処理、対象範囲に含まれるテスト、ダッシュボードまたはスキーマ、リリース設定を確認します。問い、意思決定、担当者、対象ユーザー、成功の定義を明確にしてください。

各イベントには、意味上のトリガー、安定した名前、範囲が限定された型付きプロパティ、ID と同意のポリシー、配信要件、検証計画が必要です。イベントはウィジェットの build、付随的な再ビルド、ルートオブザーバー、ボタンコールバックから同時にではなく、ドメイン上の発生ごとに一度だけ送信します。

イベントを提案または修正するときは、アダプターに判断を委ねたり質問したりせず、契約を明示してください。どの ID（匿名または認証済み）を関連付けるのか（ログイン時やアカウント切り替え時にどうなるかを含む）、同意がオフの場合にイベントを破棄するのかキューに入れるのか、配信セマンティクス（例：重複排除キーを使った少なくとも1回の配信）、再試行とプロセス再起動時のルールを定めます。プロジェクトに記載がない場合は、保守的な既定値を選び、仮定であることを明記し、変更できる担当者を示してください。

必要に応じてリファレンスを確認

  • 名前、プロパティ、意味上のトリガー、ファネル、収益イベント、スキーマの進化、重複防止を定義する場合は、イベント契約とオーナーシップを確認してください。
  • 匿名および認証済み ID、アカウント切り替え、オプトインまたはオプトアウト、削除、機微データ、広告アトリビューション、オフラインバッファリングについては、ID、同意、プライバシーを確認してください。
  • DebugView またはライブデバッグツール、バックエンドの検査、環境、ファネルの検証、実験の露出、ロールアウトの根拠については、検証と実験を確認してください。

境界

  • flutter-observability は運用エラー、ログ、トレース、リリースコンテキスト、インシデント診断を担当します。プロダクト分析はユーザー行動、ファネル、アトリビューション、コンバージョン、実験を担当します。
  • flutter-in-app-purchases は検証済みの取引と権利を担当します。分析はその結果を観測してもかまいませんが、アクセスを許可したり、購入の真実性を定義したりしてはなりません。
  • flutter-navigation はルートの正確性を担当します。分析はナビゲーションをベンダーに結び付けずに、意味のある画面やジャーニーのセマンティクスを対応付けます。
  • flutter-authentication はセッション状態を担当します。分析は明示された ID とアカウントのライフサイクルに従います。
  • flutter-persistence はストレージの仕組みを担当します。このスキルは、同意に配慮した範囲限定のバッファリングとイベント削除の要件を定めます。
  • flutter-security は広範なプライバシーと脅威のレビューを担当します。

検証

プロバイダーに依存しないアダプターとセマンティックプロデューサーを、決定論的にテストします。厳密に1回だけのイベント送信、プロパティの検証、同意状態の遷移、匿名から認証済みへのIDの移行、ログアウトとアカウントの切り替え、オフラインキューの上限、リトライ時の重複、環境の分離、プロバイダーの障害を網羅します。

許可された非本番のアナリティクスプロジェクトまたはデバッグ画面を使用して、期待する名前、プロパティ、ID、タイムスタンプ、同意状態、環境でイベントが1回届くことを確認します。タスクに含まれる場合は、後続のスキーマ、ファネル、または実験のコンシューマーも検証します。SDK呼び出しの成功やコンソールログは、エンドツーエンドのアナリティクスを示す証拠にはなりません。

プロバイダーやダッシュボードへのアクセスが許可されていない場合は、観測できていないため、プロバイダーへの取り込みと各後続のダッシュボード、ファネル、または実験の境界を未検証として明示的に記録します。この証拠の不足を、曖昧な「保留中」というステータスにまとめないでください。

ソース

コメント

Markdown 対応