mcpField
V
vercel-deploy

vercel-deploy

github.com/hainrixzクラウド・DevOps28480 回インストール5 日前に更新
リポジトリ

vercel-deploy について

vercel-deployは、Vercelへのプロジェクトデプロイを行うスキルです。プレビューへのデプロイを既定とし、CLIで認証できない場合は代替スクリプトを使います。

主な機能

  1. 01プロジェクトのVercelへのデプロイ
  2. 02プレビュー環境へのデプロイが既定
  3. 03利用可能なVercel CLIの使用
  4. 04認証不要の代替デプロイスクリプト
  5. 05プレビューURLとclaim URLの返却

活用シーン

  1. 01プロジェクトをプレビューとしてデプロイ
  2. 02指定したプロジェクトパスのデプロイ
  3. 03明示的な依頼に応じた本番デプロイ

インストール

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

$npx skills add https://github.com/hainrixz/claude-webkit --skill vercel-deploy

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

同梱ファイルLICENSE.txtscripts/deploy.sh

詳細

Note: claude-webkit では、このスキルが主要なデプロイ方法です。CLAUDE.md の Phase 6 では、 bash .claude/skills/vercel-deploy/scripts/deploy.sh site を直接実行します。

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 対応