用途
vercel-deploy 是一个针对 Vercel 平台的部署操作技能，适用于已经选定 Vercel 作为部署平台、需要对已关联的 Web 或全栈项目执行具体部署操作的场景。它不负责设计通用的发布策略、发布门禁、金丝雀策略或跨平台部署方案，而是作为 Vercel 专属的“操作入口”，处理预览部署、生产部署、提升上线、别名与域名、环境变量同步以及回滚响应等任务。
主要能力
该技能将 Vercel 操作归纳为六种主模式：
- preview-deploy：创建或刷新可测试的 Vercel 预览部署。
- production-deploy：执行一次直接的全新生产部署。
- promote-preview：验证已有部署后，将其提升为当前生产版本。
- alias-domain：应用或验证稳定预览别名或自定义域名。
- env-sync：修复环境变量作用域或本地/项目环境状态过期问题。
- rollback-response：将生产回退到已知良好的部署并验证恢复情况。
此外，技能还提供支持文档，包括模式与边界说明、预览与生产命令包、环境变量/域名/回滚故障排查等参考。
使用方式
使用该技能时，首先需要将 Vercel 任务归一化为一个数据包，明确主模式、项目状态（已关联/未关联/未知）、构建模式（源码构建/预构建/未知）、目标环境、URL 目标以及验证深度。随后收集最小可信证据，例如项目是否已关联 Vercel、目标环境是预览还是生产、部署路径是源码还是预构建、用户关心的是生成的部署 URL 还是稳定别名或自定义域名、问题本质是部署切换还是环境配置不匹配、期望的验证证明是什么。接着根据主模式选择对应的操作路径，避免一次性倾倒所有命令。最后以模式特定的摘要格式输出结果，包含模式、项目关联状态、构建模式、目标环境、URL/部署、已执行的验证、剩余风险或手动步骤以及路由出去的工作。
适用场景
- 用户明确希望在 Vercel 上部署项目。
- 任务涉及 Vercel 预览 URL、预览别名或稳定演示环境。
- 已存在关联的 Vercel 部署，需要提升或回滚处理。
- 主要问题是 Vercel 环境变量作用域、Vercel 域名/别名状态或 Vercel 专属的发布验证。
- 平台已选定，用户需要 Vercel 操作指导而非供应商中立的发布设计。
限制
该技能不适用于以下情况：主要问题是通用发布策略、发布门禁、金丝雀策略或跨平台部署设计；主要工作是编辑 GitHub Actions、CI YAML 或任务运行器；主要工作是安装 Node、Vercel CLI、认证引导或关联本地机器；应用/框架/构建在部署路径本身可用之前就已损坏；主要工作是发布后的长期遥测、SLO 或告警。这些情况应分别路由到 deployment-automation、system-environment-setup、debugging 或相关框架/构建技能、monitoring-observability 等。
该技能还提到一个遗留的可认领部署辅助脚本 scripts/deploy.sh，它打包 tarball 并返回预览/认领 URL。仅当运行时明确期望可认领部署端点、任务只是创建可认领预览 URL、且关联项目、提升、别名/域名、环境同步和回滚操作均不在范围内时，才应使用该脚本；否则应优先使用官方 Vercel CLI 或仪表板模型。
最佳实践
在给出命令前先选择一个主要的 Vercel 模式；优先使用关联项目、官方 CLI/仪表板流程而非遗留 tarball 快捷方式；将部署、提升、别名/域名、环境修复和回滚视为不同的操作包；始终区分生成的部署 URL、稳定预览别名和自定义域名；注意环境变量更改仅影响新部署；不要过度宣传 vercel promote 或 rollback 是无损的，应指出作用域、域名、计划或配置方面的注意事项；将通用发布设计路由回 deployment-automation 以避免重叠。