mcpField
V
vercel-deploy

vercel-deploy

github.com/hainrixz云与 DevOps28480 次安装5 天前更新
代码仓库

关于 vercel-deploy

vercel-deploy 是用于将项目部署到 Vercel 的技能，供执行部署的 Agent 或开发者使用。默认创建预览部署，并提供 CLI 无法认证时的备用脚本。

主要功能

  1. 01将项目部署到 Vercel
  2. 02默认创建预览部署
  3. 03使用可用的 Vercel CLI
  4. 04提供免认证部署备用脚本
  5. 05返回预览和认领 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

详细介绍

注意： 在 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。

不要 curl 或获取已部署的 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