Agent Skills
返回列表
🔒

Vercel 部署

IT 运维与安全 更新于 2026.08.30

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

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

技能介绍

痛点:发布不等于「跑一条命令」

把 Next.js 推到 Vercel 很容易误伤线上:vercel --prod 立刻对用户可见;未 vercel link 的项目可能部署到错误账号;预览里能跑、生产缺环境变量是经典故障。生产晋升、回滚、改 env 都应该是带确认的发布动作,而不是助手顺手执行的一条 CLI。

技能如何组织发布流程

技能把部署当成契约式操作,输入为已关联的 Vercel 项目与模式(preview 默认、prod、rollback、env),输出为预览/生产 URL、回滚后的部署或环境变量变更摘要。

  • Step 0:若缺少 .vercel/project.json,停止并要求用户自行执行 vercel link,助手不得代连,避免链错项目。
  • Step 1(preview):默认路径,只产出预览 URL,用于评审,永不默认上生产。
  • Step 2(prod):先说明将要上线的分支/提交,确认监控(可委托 monitoring-setup),高风险发布可走 dependency-audit / security-audit 门禁;优先 promote 已评审的 preview,而非重新 --prod 构建。
  • Step 3(rollback):点名目标部署(URL + commit)并确认后再回滚。
  • Step 4(env):按环境管理变量;不得在对话中回显密钥;刻意保证 dev / preview / production 一致,避免「预览正常、生产 500」。

边界与反模式

不涉及 git 写入;所有生产部署、晋升、env 变更与回滚均需确认。应避免:未关联项目就部署、无确认直接 --prod、跳过已测 preview 直接全新生产构建、无目标名的回滚。

使用场景

  • 评审合并后的功能分支,需要生成可分享的 Vercel 预览链接给产品验收
  • 热修复已进 preview 且验过,要把同一构建晋升到生产并先确认监控与分支信息
  • 生产发布后接口大量 500,需要点名上一版部署 URL/commit 并确认后回滚
  • 新接入第三方 API,要在 preview 与 production 同步补齐环境变量且不在对话里泄露密钥

适合人员

  • 维护公司 Next.js 站点的全栈工程师,希望默认走 preview、上生产必须人工确认
  • 负责 on-call 的 SRE,需要在事故窗口里按 URL/commit 精确回滚 Vercel 生产部署
  • 带小团队交付 SaaS 的技术负责人,要求发布前串联监控与依赖/安全审计门禁
  • 单人维护 side project 的独立开发者,常踩 preview 有变量、production 缺变量导致的线上故障