Vercel 部署
将以下提示词粘贴到你的 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 缺变量导致的线上故障