部署到 Vercel
将以下提示词粘贴到你的 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` 探测。