Agent Skills
返回列表
🔒

部署到 Vercel

IT 运维与安全 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-agent-skills-deploy-to-vercel。

技能介绍

要解决的问题

在对话式编程或沙箱环境里,把本地目录发到 Vercel 并拿到可访问的 URL 并不只是跑一条 vercel deploy。项目可能还没 vercel link、属于多个 Team、没有 Git remote,或者根本不能交互式 vercel login。若在未判断 .vercel/ 是否存在时就调用 vercel link 或 vercel ls,还可能在未链接目录里触发静默关联,把状态弄乱。

技能如何工作

技能把部署写成按项目状态选路径的决策流:

  • 先采集状态:用 vercel whoami 与是否存在 .vercel/project.json / .vercel/repo.json 判断是否已链接;多 Team 时列出 slug 让用户选定,后续命令统一带 --scope。
  • 已链接且有 Git remote:在明确征得用户同意后 commit/push,再用 vercel ls --format json 取最新预览地址(非生产分支为 preview)。
  • 已链接无 Git:vercel deploy 配合 --no-wait,用 vercel inspect 跟构建状态。
  • 未链接但 CLI 已登录:优先 vercel link --repo(有 remote 时),否则普通 vercel link,再按是否有 remote 选 push 或 CLI 部署。
  • 未安装或未登录:安装 CLI、浏览器登录;无法在沙箱登录时走 no-auth 脚本,返回 Preview URL 与 Claim URL(claude.ai / Codex 各有分支说明)。

默认策略是 Always deploy as preview,除非用户明确要求 production。输出阶段只交付链接,不会去 curl 验证站点是否存活。

适用边界与注意点

  • Git push 路径禁止未经用户批准就 push。
  • 未链接目录里不要用 vercel project inspect、vercel ls、vercel link 做探测(除 vercel whoami 外),以免交互或 --yes 副作用。
  • 沙箱网络受限时,仅对实际部署命令考虑提升权限(Codex 的 sandbox_permissions=require_escalated),不要用提升权限去检查 vercel 是否已安装。
  • 认证失败应回退到对应环境的 no-auth 部署脚本,而不是反复要求登录。

使用场景

  • 在 Claude 沙箱里无法 `vercel login`,需要把当前前端目录打成包并拿到可分享的 Preview 与 Claim 链接。
  • 本地已有 `.vercel/repo.json` 且配置了 Git remote,希望助手在确认后 push 并解析最新 preview 的 `url` 字段。
  • 项目已 `vercel link` 但没有 Git 仓库,需要用 `vercel deploy --no-wait` 快速返回部署地址并跟进构建状态。
  • 多 Team 账号下要把新仓库用 `vercel link --repo` 绑到指定 scope,再走长期 git-push 部署路径。

适合人员

  • 在 Agent 终端里做全栈迭代的开发者,希望默认只上 Vercel 预览、避免误推 production。
  • 维护 monorepo 或目录名与 Vercel 项目名不一致的工程师,需要用 `--repo` 链接而不是靠文件夹名猜测项目。
  • 在 Codex/claude.ai 受限环境里演示部署的运营或技术布道,需要无凭证部署脚本与 Claim 流程说明。
  • 负责团队 Vercel 多 Org 发布权限的 DevOps,需要每次 CLI 命令带正确 `--scope` 且不乱跑 `vercel link` 探测。