installing-posthog-from-chat について
GitHub リポジトリで PostHog のセットアップを開始し、進捗を確認するガイドスキルです。クラウドで変更を作成してプルリクエストを開き、レビューとマージ後に反映します。
主な機能
- 01GitHub 接続の確認
- 02リポジトリの検索と確認
- 03セットアップ実行の開始と追跡
- 04プルリクエスト結果の共有
活用シーン
- 01GitHub リポジトリへの PostHog のセットアップ
- 02実行状況の追跡と変更のレビュー
MCP 対応
PostHog のツールを使って GitHub の連携とリポジトリを確認し、セットアップ実行の開始と状態確認を行います。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/installing-posthog-from-chatを入力して読み込まれたか確認します。
詳細
チャットから PostHog をインストールする
Wizard は PostHog のセットアップエージェントです。wizard-install-start を使うと、GitHub リポジトリ上のクラウドワークスペースで実行され、コードを変更してプルリクエストを作成します。ユーザーはそのプルリクエストを確認してマージします。ユーザーがマージするまでは、デフォルトブランチに変更は加えられません。
手順を順番に進めてください。会話からすでに結果が分かっている手順はスキップしてください。
1. GitHub を接続する
実行ではプロジェクトの GitHub 接続を使用するため、プロジェクトに接続が必要です。
integrations-listを呼び出し、github種別のインテグレーションを探します。- 見つからない場合は、コンテキスト内のベース URL とプロジェクト ID を使って、次のリンクをユーザーに提示します：
<base URL>/integrations/connect/github/?project_id=<project id>&connect_from=mcp。ユーザーは PostHog GitHub App をインストールし、アクセスを許可するリポジトリを選択します。完了したとユーザーが伝えたら、もう一度integrations-listを呼び出します。
2. リポジトリを選ぶ
GitHub インテグレーションの ID を使って integrations-github-repos-retrieve を呼び出します。ユーザーがリポジトリ名を指定した場合は search を使い、has_more が true のときは offset を使ってページを進めます。
- 明確な候補が 1 つ：1 行でユーザーに確認します。
- 候補が複数：候補を一覧表示し、どれを使うか尋ねます。
- 候補なし：GitHub App がそのリポジトリにアクセスできません。GitHub でアプリのリポジトリアクセスにリポジトリを追加してから、もう一度検索するようユーザーに依頼します。
リポジトリは full_name（owner/name）として渡します。
セットアップエージェントはリポジトリのルートで作業します。アプリがサブディレクトリにあるモノレポについてユーザーが説明した場合、実行時にアプリが見つからない可能性があることを伝え、それでも試すか尋ねます。
3. 実行を開始する
以下を指定して wizard-install-start を呼び出します。
repository：手順 2 のowner/name。branch：ユーザーがデフォルト以外のブランチを希望する場合のみ指定します。プルリクエストはそのブランチを対象にします。idempotency_key：このリクエスト用の新しい一意の値。ネットワークエラー後に再試行する場合は同じ値を再利用し、再試行で同じ実行が返されるようにします。
ユーザーが対処できるエラー：
| エラーコード | 対処 |
|---|---|
github_not_connected | 手順 1 に戻ります。 |
repository_not_accessible | ユーザーにリポジトリを PostHog GitHub App に追加するよう依頼してから、新しい idempotency_key で再試行します。 |
run_already_active | このプロジェクトでは、すでに実行が進行中です。完了を待つか、PostHog で確認するようユーザーに伝えます。 |
| HTTP 429 | セットアップ実行の時間あたりまたは日あたりの上限に達しました。メッセージを伝え、すぐに再試行しないでください。 |
実行が開始されたことをユーザーに伝え、PostHog で進行状況を確認できるよう、レスポンスの url を共有します。
4. 実行状況を確認する
status が created または running の間は、約 30 秒ごとに run_id を指定して wizard-install-status を呼び出します。通常、実行には数分かかります。
next_stepが変わったらユーザーに伝えます。そのまま渡せるように書かれています。- 役立つ場合は
tasksの進捗を伝えますが、ポーリングのたびに更新を送る必要はありません。 statusがcompleted、failed、またはcancelledになったら、ポーリングを停止します。
クライアントが 1 回の応答でそれほど長く待てない場合は、実行中であることをユーザーに伝え、ユーザーが戻ってきたときにもう一度確認します。
5. 結果を共有する
pull_request_urlを伴うcompleted：リンクを共有します。PostHog のセットアップを完了するには、変更を確認してプルリクエストをマージするようユーザーに伝えます。pull_request_urlを伴わないcompleted：セットアップエージェントは何も変更していません。多くの場合、PostHog はすでにセットアップ済みです。next_stepを伝えます。failed：next_stepとerror_messageを伝えます。next_stepが新しい実行を示唆している場合は、新しい実行を開始することを提案します。