name: vercel-deploy description: 部署应用程序和网站到Vercel。当用户请求部署操作如“部署我的应用”、“部署并给我链接”、“推送到线上”或“创建预览部署”时使用。 metadata: author: github.com/openai/skills version: ‘1.0.0’
Vercel 部署
即时部署任何项目到Vercel。始终部署为预览(非生产环境),除非用户明确要求生产环境。
前提条件
- 当沙盒环境阻止部署网络调用时,使用
sandbox_permissions=require_escalated重新运行。 - 部署可能需要几分钟。使用适当的超时值。
快速开始
只需运行以下命令(使用10分钟超时):
vercel deploy [path] -y
重要: 部署命令使用10分钟(600000毫秒)超时,因为构建可能需要一些时间。
如果失败并显示“未找到现有凭据”,请使用下面的备用方法。
备用方法(无认证)
如果CLI因认证错误失败,使用部署脚本:
# 部署当前目录
bash scripts/deploy.sh
# 部署特定项目
bash scripts/deploy.sh /path/to/project
# 部署现有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)。当沙盒网络阻止出站请求时,部署需要提升的网络访问权限。
示例指导用户:
部署需要提升的网络访问权限来部署到Vercel。我可以使用提升权限重新运行命令——要继续吗?