mcpField
I
integration-astro-static

integration-astro-static

github.com/posthogデータ・データベース7695 回インストール今日更新
リポジトリ

integration-astro-static について

静的な Astro アプリに PostHog 分析機能を追加するためのスキルです。段階的な手順とサンプルに加え、スクリプト、環境変数、再利用可能な初期化に関する Astro 固有の指針を示します。

主な機能

  1. 014段階の統合ワークフロー
  2. 02Astro のサンプルとドキュメント
  3. 03PostHog スクリプトのインライン指定
  4. 04PUBLIC_ 環境変数の設定指針
  5. 05再利用可能なコンポーネント初期化
  6. 06ユーザー識別とエラー追跡

活用シーン

  1. 01静的 Astro アプリへの PostHog 導入
  2. 02クライアント用プロジェクトトークンの設定
  3. 03レイアウトを使った初期化の共通化
  4. 04ユーザー識別とエラー追跡

インストール

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

$npx skills add https://github.com/posthog/skills --skill integration-astro-static

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

同梱ファイル

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

references/
astro.md
basic-integration-1.0-begin.md
basic-integration-1.1-edit.md
basic-integration-1.2-revise.md
basic-integration-1.3-conclude.md
EXAMPLE.md
identify-users.md

詳細

Astro(静的サイト)向け PostHog インテグレーション

このスキルでは、Astro(静的サイト)アプリケーションに PostHog のアナリティクスを追加する方法を説明します。

ワークフロー

インテグレーションを完了するには、次の手順を順番に実行してください。

  1. basic-integration-1.0-begin.md - PostHog のセットアップ - 開始 ← ここから開始
  2. basic-integration-1.1-edit.md - PostHog のセットアップ - 編集
  3. basic-integration-1.2-revise.md - PostHog のセットアップ - 修正
  4. basic-integration-1.3-conclude.md - PostHog のセットアップ - 完了

参照ファイル

  • references/EXAMPLE.md - Astro(静的サイト)のサンプルプロジェクトコード
  • references/astro.md - Astro - ドキュメント
  • references/identify-users.md - ユーザーの識別 - ドキュメント
  • references/basic-integration-1.0-begin.md - PostHog のセットアップ - 開始
  • references/basic-integration-1.1-edit.md - PostHog のセットアップ - 編集
  • references/basic-integration-1.2-revise.md - PostHog のセットアップ - 修正
  • references/basic-integration-1.3-conclude.md - PostHog のセットアップ - 完了

サンプルプロジェクトには、目標とする実装パターンが示されています。API の詳細についてはドキュメントを参照してください。

主な原則

  • 環境変数:PostHog のキーには必ず環境変数を使用してください。ハードコードはしないでください。
  • 最小限の変更:既存のインテグレーションに PostHog のコードを追加してください。既存のコードを置き換えたり、構成し直したりしないでください。
  • サンプルに合わせる:実装は、できる限りサンプルプロジェクトのパターンに沿ってください。

フレームワークのガイドライン

  • Astro による処理や TypeScript エラーを防ぐため、PostHog のスクリプトタグには必ず is:inline ディレクティブを使用してください
  • Astro では、クライアント側の環境変数に PUBLIC_ プレフィックスを使用してください(例:PUBLIC_POSTHOG_PROJECT_TOKEN)
  • ページ間で初期化処理を再利用できるように、src/components/ に posthog.astro コンポーネントを作成してください
  • PostHog コンポーネントを Layout にインポートし、すべてのページをその Layout でラップしてください

ユーザーの識別

ログイン時とサインアップ時にユーザーを識別してください。このフレームワークで適切な identify パターンを実装する方法については、サンプルコードとドキュメントを参照してください。フロントエンドとバックエンドの両方のコードがある場合は、クライアント側のセッションと distinct ID を X-POSTHOG-DISTINCT-ID および X-POSTHOG-SESSION-ID ヘッダーで渡し、相関関係を維持してください。

エラー追跡

特に重要なユーザーフローや API の境界で、関連するファイルに PostHog のエラー追跡を追加してください。

コメント