mcpField
E
error-tracking-svelte

error-tracking-svelte

github.com/posthog開発7694 回インストール今日更新
リポジトリ

error-tracking-svelte について

Svelte アプリに PostHog のエラートラッキングを追加する開発者向けのガイドスキルです。既存のエラー処理を維持し、例外の自動捕捉を先に有効化する方針と、ソースマップやアラートの参考資料を示します。

主な機能

  1. 01PostHog エラートラッキング導入の案内
  2. 02キーに環境変数を使う方針
  3. 03例外の自動捕捉を優先
  4. 04ソースマップとアラートの参考資料
  5. 05Svelte ツールによるコンポーネント確認の推奨

活用シーン

  1. 01Svelte アプリへのエラー監視の導入
  2. 02エラーバウンダリでの例外捕捉
  3. 03ソースに対応しないスタックトレースの調査
  4. 04新規・変更した Svelte コンポーネントの検証

MCP 対応

Svelte MCP サーバーを使った Svelte ドキュメントの参照とコンポーネント検証を推奨します。ドキュメント検索ツールと svelte-autofixer を利用します。

インストール

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

$npx skills add https://github.com/posthog/skills --skill error-tracking-svelte

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

同梱ファイル

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

references/
alerts.md
assigning-issues.md
fingerprints.md
monitoring.md
svelte.md
upload-source-maps.md

詳細

Svelte 向け PostHog エラートラッキング

このスキルは、Svelte アプリケーションへの PostHog エラートラッキングの追加を支援します。

参考ファイル

  • references/svelte.md - Sveltekit のエラートラッキング導入 - ドキュメント
  • references/fingerprints.md - フィンガープリント - ドキュメント
  • references/alerts.md - エラートラッキングのアラートを送信する - ドキュメント
  • references/monitoring.md - 問題を監視して検索する - ドキュメント
  • references/assigning-issues.md - チームメイトに問題を割り当てる - ドキュメント
  • references/upload-source-maps.md - ソースマップをアップロードする - ドキュメント

API の詳細やフレームワーク固有のパターンについては、ドキュメントを参照してください。

重要な原則

  • 環境変数：PostHog のキーとホスト URL には、必ず環境変数を使用してください。ハードコードしないでください。
  • 変更は最小限に：既存のエラー処理に加える形でエラートラッキングを追加してください。既存のエラー処理コードを置き換えたり、再構成したりしないでください。
  • まずは自動キャプチャ：手動キャプチャを追加する前に、SDK の初期化時に例外の自動キャプチャを有効にしてください。
  • ソースマップ：スタックトレースが圧縮されたバンドルではなく、元のソースコードを参照するよう、ソースマップをアップロードしてください。
  • 境界では手動キャプチャ：グローバルハンドラーに伝播しないエラーには、エラー境界や catch ブロックで captureException() を使用してください。

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

  • svelte.config.js で paths.relative を false に設定してください。これは、SSR で PostHog のセッションリプレイが正しく動作するために必要ですが、見落としやすい設定です。
  • Svelte のドキュメントを確認するには Svelte MCP サーバーのツール（list-sections、get-documentation）を使用し、コンポーネントを検証するには svelte-autofixer を使用してください。完了前に、新規または変更した .svelte ファイルには必ず svelte-autofixer を実行してください。

コメント

Markdown 対応