mcpField
V
vercel-deploy

vercel-deploy

github.com/openai云与 DevOps28.4k3.4k 次安装18 周前更新
代码仓库

关于 vercel-deploy

vercel-deploy 是将项目部署到 Vercel 的技能，可使用 Vercel CLI；认证失败时提供脚本作为备用方案。默认创建预览部署，只有明确要求时才部署到生产环境。

主要功能

  1. 01检查 Vercel CLI 是否可用
  2. 02默认创建预览部署
  3. 03CLI 认证失败时使用脚本
  4. 04备用部署返回预览和认领链接
  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。

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

故障排除

提升网络访问权限

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