mcpField
V
vercel

vercel

github.com/remotion-devクラウド・DevOps68.6k501 回インストール今日更新
リポジトリ

vercel について

`remotion` プロジェクトの特定の Vercel デプロイを監視するリポジトリ用スキルです。可変のプレビューエイリアスではなく、不変のデプロイ識別子を使い、機械可読な状態を確認します。

主な機能

  1. 01デプロイ ID または不変ホスト名に固定
  2. 02指定されたプロジェクト情報源からデプロイを特定
  3. 03機械可読なデプロイ状態を取得
  4. 04進行中・成功・失敗の状態を判定
  5. 05回数上限付きの毎分ハートビートを作成

活用シーン

  1. 01PR またはコミットに対応するデプロイを監視
  2. 02ビルドの準備完了または失敗を確認
  3. 03古いプレビューエイリアスを新しいデプロイと誤認しない

インストール

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

$npx skills add https://github.com/remotion-dev/remotion --skill vercel

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

同梱ファイルagents/openai.yamlscripts/check-deployment.py

詳細

Vercel モニター

remotion プロジェクトの変更されない Vercel デプロイメントを 1 つ監視し、その正確なデプロイメントの準備が完了するか失敗したときに、現在のタスクに通知します。

絶対に守るルール

  • HTTP レスポンスからデプロイメントの状態を推測してはいけません。ブランチプレビューのエイリアスは、新しいデプロイメントのビルド中でも前のデプロイメントから 200 を返すことがあります。
  • ブランチプレビューのエイリアスを監視してはいけません。エイリアスは移動するため、古いデプロイメントまたは新しいデプロイメントを指す可能性があります。
  • Vercel デプロイメント ID（dpl_...）または変更されない自動デプロイメントのホスト名（<project>-<random>-<scope>.vercel.app）を監視対象に固定してください。
  • 機械可読な Vercel デプロイメントの状態を読み取ってください。人間向けの CLI 出力を解析してはいけません。
  • デフォルトでは、remotion プロジェクトと remotion Vercel スコープを使用してください。ユーザーが明示的に求めない限り、bugs プロジェクトは無視してください。

正確なデプロイメントを特定する

次の情報源を、上から順に優先してください。

  1. ユーザーから提供された Vercel デプロイメント／ダッシュボード URL。
  2. アクティブな GitHub PR の Vercel – remotion チェック。ダッシュボード URL の形式は https://vercel.com/remotion/remotion/<deployment-id-suffix> です。
  3. Vercel ボットの PR コメントにある remotion の行。
  4. vercel list remotion --scope remotion --format=json。.deployments[].meta 内の正確な PR、コミット SHA、またはブランチと照合します。

ダッシュボード URL の最後のパス要素の前に dpl_ を付けると、デプロイメント ID になります。例：

https://vercel.com/remotion/remotion/AbCd1234 -> dpl_AbCd1234

Vercel の PR コメントにある Preview リンクは通常、ブランチエイリアスです。最終通知用に保持しますが、状態チェックには使用しないでください。

vercel list を使用する場合は、利用可能なすべての識別情報に一致する、最新のデプロイメントを選択してください。

  • .name == "remotion"
  • PR が判明している場合、.meta.githubPrId == <PR number>
  • コミットが判明している場合、.meta.githubCommitSha == <full commit SHA>

別のコミットに暗黙的に切り替えてはいけません。正確なデプロイメントを特定できない場合は、Vercel ダッシュボード URL、PR 番号、またはコミット SHA を尋ねてください。

状態を読み取る

リポジトリのルートから、同梱のチェッカーを実行してください。

python3 .agents/skills/vercel/scripts/check-deployment.py <deployment-id-or-url>

チェッカーは次を呼び出します。

vercel inspect <deployment-id-or-immutable-url> \
  --scope remotion \
  --format=json

チェッカーはプロジェクトを検証し、移動するエイリアスを拒否して、正規化された JSON を出力します。その state フィールドを使用してください。

  • READY：成功です。
  • ERROR、CANCELED、または CANCELLED：失敗です。
  • BUILDING、QUEUED、または INITIALIZING：まだ進行中です。
  • UNKNOWN：終端状態ではありません。診断は、それが継続する場合、または信頼できるモニターの作成を妨げる場合に限り報告してください。

READY になった後であれば、任意の到達可能性チェックとして HTTP プローブを使用できます。準備未完了または不明なデプロイメントを READY にしてはいけません。

モニターを作成する

Codex 自動化ツールを使って、通常は 30 回を上限とする、1 分間隔のハートビートを作成してください。ハートビートのプロンプトは単独で完結するものとし、次の情報を含めてください。

  • 固定されたデプロイメント ID または変更されないデプロイメントのホスト名。
  • ダッシュボード URL。
  • 判明している場合は、最終通知用のブランチプレビューエイリアス。
  • 判明している場合は、プロジェクト、PR、ブランチ、コミットの情報。
  • 正確なチェッカーコマンド。
  • 上記の終端状態のルール。

次の形式のプロンプトを使用してください。

Monitor this exact Vercel deployment until it reaches a terminal state.

Pinned deployment: <dpl_id_or_immutable_hostname>
Dashboard: <dashboard_url>
Preview alias (reporting only; never use for state): <preview_url_or_unknown>
Context: <project/pr/branch/commit>

From the repository root, run:
python3 .agents/skills/vercel/scripts/check-deployment.py <pinned_deployment>

Only the JSON `state` is authoritative.
- READY: reply "Vercel deployment is ready" and include Dashboard and Preview.
- ERROR, CANCELED, or CANCELLED: reply with the failure state and include both links.
- BUILDING, QUEUED, INITIALIZING, or UNKNOWN: stay quiet and check again next time.

Never curl the preview URL to determine readiness. After reporting a terminal
state, delete or pause this heartbeat if its automation ID is available.

ハートビートを作成する前に、チェッカーを一度実行してください。デプロイメントがすでに終端状態の場合は、代わりにすぐに報告してください。それ以外の場合は、監視対象の正確なデプロイメントと監視間隔をユーザーに伝えてください。

コメント

Markdown 対応