mcpField
V
vercel-deploy

vercel-deploy

github.com/davila7云与 DevOps33.0k96 次安装今天更新
代码仓库

关于 vercel-deploy

指导 AI Agent 将项目部署到 Vercel，默认创建预览部署；CLI 无法认证时提供脚本备用方案。

主要功能

  1. 01将项目部署到 Vercel
  2. 02默认创建预览部署
  3. 03CLI 认证失败时使用脚本
  4. 04返回部署和认领链接

适用场景

  1. 01在 Vercel 发布项目预览
  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 部署

立即将任意项目部署到 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。对于备用方法部署，还要展示认领 URL。

不要使用 curl 或获取已部署的 URL 来验证其是否可用。只需返回链接。

故障排除

提升网络访问权限

如果部署因网络问题而失败（超时、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