Vercel 预览部署助手
将应用或网站部署到 Vercel 并返回预览链接。
证据显示默认预览部署、生产部署需用户明确请求,并排除 .env、node_modules 和 .git;但部署会将打包项目上传至固定外部端点,未充分披露数据流、未要求部署前确认、未提供回滚或删除路径,且 claimUrl 的敏感性未说明。脚本还实际轮询外部预览 URL,与文档“Do not curl”矛盾,因此扣分。
证据显示脚本具备输入类型检查、临时目录、清理逻辑和有限轮询;但 JSON 通过 grep 解析、curl 缺少明确超时和健壮错误处理,4xx 被视为成功,5xx 被笼统视为构建中,且文档与脚本在 URL 轮询行为上不一致。静态评估受限,得分不超过 10。
证据显示触发语句、预览与生产边界、目录和 tgz 输入均较明确;但没有中文使用说明、非适用场景或环境边界,核心功能依赖 Vercel 和海外网络端点,可能受中国大陆网络可达性影响,因此扣分。
证据显示文档包含前置条件、快速开始、回退方案、生产部署和故障排查;但没有安装 CLI 的说明、示例输出或 FAQ,许可证元数据未知,缺少版本、变更记录和明确维护责任。仓库 README 还声明仓库已弃用,降低维护可持续性。
证据显示目标是部署项目并返回 previewUrl,回退流程还返回 claimUrl,核心产出格式直接可用;但没有文件内的真实执行证据,框架检测和部署状态判断存在局限,无法静态确认结果正确性或完整性,因此按静态上限保守扣分。
证据显示部署脚本和行为路径可审计,且输出 JSON 字段有明确约定;但未提供覆盖关键路径的测试、CI 执行记录或第三方复核,外部部署端点的行为也无法由文件独立验证,因此得分受静态上限限制。
- 部署前应明确告知用户项目文件将上传到固定外部端点,并在执行前获得确认。
- 应统一文档与脚本对预览 URL 轮询的规定,并增加网络超时、响应校验和失败诊断。
- 应说明 claimUrl 的管理权限和保密要求,并提供取消、删除或回滚部署的路径。
- Vercel 和部署端点可能受中国大陆网络可达性影响,使用前应验证网络条件。
它能做什么 & 适用场景
该技能用于将项目部署到 Vercel。除非用户明确要求生产环境,否则始终创建预览部署。它会先检查 Vercel CLI,必要时改用随技能提供的部署脚本。成功后返回预览 URL;使用脚本时还会返回认领 URL。该技能属于已弃用的 openai/skills 仓库中的 curated 技能。
检查系统中是否安装 Vercel CLI;使用 vercel deploy [path] -y 创建预览部署;如果 CLI 不可用或缺少凭据,则运行 scripts/deploy.sh,支持当前目录、指定项目路径或现有 tarball;脚本负责框架检测、打包并等待构建完成;部署成功后输出 previewUrl,脚本方式还输出 claimUrl。
- 开发者希望把当前应用快速发布为 Vercel 预览环境时。
- 团队成员需要为指定项目创建可分享的预览部署时。
- 用户明确要求将应用上线到生产环境时。
- 用户没有 Vercel CLI 或现有凭据,需要使用无认证回退脚本时。
优缺点一览
- 默认使用预览部署,适合分享和审阅。
- 同时支持 Vercel CLI 和无认证回退脚本。
- 回退脚本支持框架检测、打包和构建等待。
- 输出部署链接;脚本部署还提供认领链接。
- 仓库 README 已标记为弃用。
- 生产部署必须由用户明确要求。
- 部署可能需要网络访问;沙箱阻止网络时需要对实际部署命令提升权限。
- 没有提供费用、测试覆盖或具体平台验证信息;单个技能的许可证需查看其目录中的 `LICENSE.txt`,当前资料未给出。
如何安装
该技能位于仓库的 skills/.curated/vercel-deploy。README 说明 curated 技能可在 Codex 中运行 $skill-installer vercel-deploy 安装,安装后需要重启 Codex;目标安装目录和其他安装细节未在此技能说明中展开。
如何使用
可使用触发语句“deploy my app”“deploy and give me the link”“push this live”或“create a preview deployment”。默认创建预览部署;只有用户明确要求生产环境时才使用 vercel deploy [path] --prod -y。不要通过 curl 或其他方式访问部署 URL 验证。
对比同类
资料明确提供两种路径:Vercel CLI 适用于已安装 CLI 且凭据可用的环境;部署脚本适用于 CLI 不可用或认证失败的情况。