mcpField
V
vercel-deploy

vercel-deploy

github.com/openaiクラウド・DevOps28.4k3.4k 回インストール18 週間前に更新
リポジトリ

vercel-deploy について

vercel-deployは、Vercel CLIでプロジェクトをデプロイするスキルです。CLIの認証に失敗した場合はスクリプトを使い、明示的な依頼がない限りプレビューとしてデプロイします。

主な機能

  1. 01Vercel CLIの有無を確認
  2. 02デフォルトでプレビューをデプロイ
  3. 03CLI認証失敗時にスクリプトを使用
  4. 04代替デプロイでプレビューURLと認証URLを返す
  5. 05明示的な依頼がある場合の本番デプロイ

活用シーン

  1. 01プロジェクトのプレビューを作成
  2. 02CLIに認証情報がない状態でデプロイ
  3. 03明示的な依頼に応じて本番環境へデプロイ

インストール

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

$npx skills add https://github.com/openai/skills --skill vercel-deploy

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

同梱ファイル

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

LICENSE.txt
agents/
openai.yaml
assets/
vercel-small.svg
scripts/
deploy.sh

詳細

Vercel デプロイ

あらゆるプロジェクトを Vercel にすぐにデプロイできます。ユーザーが本番環境へのデプロイを明示的に求めない限り、必ずプレビューとしてデプロイしてください（本番環境にはデプロイしないでください）。

前提条件

  • 権限を昇格させずに、Vercel CLI がインストールされているか確認してください（例：command -v vercel）。
  • サンドボックスによってデプロイ時のネットワーク呼び出しがブロックされる場合に限り、実際のデプロイコマンドの権限を昇格させてください（sandbox_permissions=require_escalated）。
  • デプロイには数分かかる場合があります。適切なタイムアウト値を指定してください。

クイックスタート

  1. Vercel CLI がインストールされているか確認します（この確認では権限を昇格させません）。
command -v vercel
  1. vercel がインストールされている場合は、次を実行します（タイムアウトは 10 分に設定します）。
vercel deploy [path] -y

重要： ビルドには時間がかかる場合があるため、デプロイコマンドのタイムアウトは 10 分（600000ms）に設定してください。

  1. vercel がインストールされていない場合、または CLI で「No existing credentials found」というエラーが発生した場合は、以下のフォールバック方法を使用してください。

フォールバック（認証なし）

CLI で認証エラーが発生した場合は、デプロイスクリプトを使用してください。

skill_dir="<path-to-skill>"

# Deploy current directory
bash "$skill_dir/scripts/deploy.sh"

# Deploy specific project
bash "$skill_dir/scripts/deploy.sh" /path/to/project

# Deploy existing tarball
bash "$skill_dir/scripts/deploy.sh" /path/to/project.tgz

このスクリプトはフレームワークの検出、パッケージ化、デプロイを処理します。ビルドの完了を待ち、previewUrl と claimUrl を含む JSON を返します。

ユーザーに伝えてください：「デプロイの準備ができました。[previewUrl] からアクセスできます。デプロイを管理するには [claimUrl] で申請してください。」

本番環境へのデプロイ

ユーザーが明示的に求めた場合に限ります。

vercel deploy [path] --prod -y

出力

デプロイ URL をユーザーに表示してください。フォールバックによるデプロイの場合は、申請 URL も表示してください。

デプロイ先 URL を curl または fetch で確認しないでください。 リンクを返すだけで構いません。

トラブルシューティング

ネットワークアクセスの権限昇格

ネットワークの問題（タイムアウト、DNS エラー、接続のリセット）が原因でデプロイに失敗した場合は、実際のデプロイコマンドを権限を昇格させて再実行してください（sandbox_permissions=require_escalated を使用します）。command -v vercel によるインストール確認では、権限を昇格させないでください。サンドボックスのネットワーク機能によって送信リクエストがブロックされる場合、デプロイにはネットワークアクセスの権限昇格が必要です。

ユーザーへの案内例：

The deploy needs escalated network access to deploy to Vercel. I can rerun the command with escalated permissions—want me to proceed?

コメント

Markdown 対応