integration-astro-static について
静的な Astro アプリに PostHog 分析機能を追加するためのスキルです。段階的な手順とサンプルに加え、スクリプト、環境変数、再利用可能な初期化に関する Astro 固有の指針を示します。
主な機能
- 014段階の統合ワークフロー
- 02Astro のサンプルとドキュメント
- 03PostHog スクリプトのインライン指定
- 04PUBLIC_ 環境変数の設定指針
- 05再利用可能なコンポーネント初期化
- 06ユーザー識別とエラー追跡
活用シーン
- 01静的 Astro アプリへの PostHog 導入
- 02クライアント用プロジェクトトークンの設定
- 03レイアウトを使った初期化の共通化
- 04ユーザー識別とエラー追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ posthog/ skills --skill integration-astro-staticインストール後、Claude Code で/integration-astro-staticを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/astro.mdbasic-integration-1.0-begin.mdbasic-integration-1.1-edit.mdbasic-integration-1.2-revise.mdbasic-integration-1.3-conclude.mdEXAMPLE.mdidentify-users.md詳細
Astro(静的サイト)向け PostHog インテグレーション
このスキルでは、Astro(静的サイト)アプリケーションに PostHog のアナリティクスを追加する方法を説明します。
ワークフロー
インテグレーションを完了するには、次の手順を順番に実行してください。
basic-integration-1.0-begin.md- PostHog のセットアップ - 開始 ← ここから開始basic-integration-1.1-edit.md- PostHog のセットアップ - 編集basic-integration-1.2-revise.md- PostHog のセットアップ - 修正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 のエラー追跡を追加してください。
コメント
Markdown 対応