mcpField
V
vercel-deploy

vercel-deploy

github.com/davila7クラウド・DevOps33.0k96 回インストール今日更新
リポジトリ

vercel-deploy について

AIエージェントによる Vercel へのプロジェクトデプロイを案内するスキルです。通常はプレビューとしてデプロイし、CLIで認証できない場合はスクリプトを使います。

主な機能

  1. 01Vercelへのプロジェクトデプロイ
  2. 02プレビューデプロイの既定化
  3. 03CLI認証失敗時のスクリプト利用
  4. 04デプロイURLとクレームURLの提示

活用シーン

  1. 01Vercelでプロジェクトのプレビューを公開
  2. 02Vercel CLIの認証情報がない状態でのデプロイ

インストール

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

$npx skills add https://github.com/davila7/claude-code-templates --skill vercel-deploy

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

同梱ファイル

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

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

詳細

Vercel Deploy

任意のプロジェクトを Vercel に即座にデプロイします。ユーザーが明示的に本番環境へのデプロイを求めない限り、常にプレビューとしてデプロイしてください（本番環境にはデプロイしないでください）。

前提条件

  • サンドボックスによってデプロイのネットワーク呼び出しがブロックされた場合は、sandbox_permissions=require_escalated を指定して再実行してください。
  • デプロイには数分かかることがあります。適切なタイムアウト値を使用してください。

クイックスタート

以下を実行してください（タイムアウトは 10 分）:

vercel deploy [path] -y

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

「No existing credentials found」というエラーで失敗した場合は、以下のフォールバック方法を使用してください。

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

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

# Deploy current directory
bash scripts/deploy.sh

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

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

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

ユーザーへの伝達: 「デプロイの準備ができました: [previewUrl]。デプロイを管理するには [claimUrl] で要求（クレーム）してください。」

本番デプロイ

ユーザーが明示的に求めた場合のみ実行してください:

vercel deploy [path] --prod -y

出力

デプロイの URL をユーザーに表示してください。フォールバックでデプロイした場合は、要求用の claim URL も表示してください。

デプロイされた URL に対して curl や fetch を実行して動作を確認しないでください。 リンクを返すだけにしてください。

トラブルシューティング

エスカレーションされたネットワークアクセス

ネットワークの問題（タイムアウト、DNS エラー、接続リセット）によりデプロイが失敗した場合は、エスカレーションされた権限でデプロイを再実行してください（sandbox_permissions=require_escalated を使用）。サンドボックスのネットワークが外向きのリクエストをブロックしている場合、デプロイにはエスカレーションされたネットワークアクセスが必要です。

ユーザーへの案内例:

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

コメント

Markdown 対応