# 部署到 Vercel (deploy-to-vercel)

> 根据项目是否已关联 Vercel、有无 git 远程和 CLI 登录状态选择部署方式，把应用部署到 Vercel 并返回链接。

- 分类: [部署与发布](https://www.myskills.tools/zh/categories/deploy-release/)
- 来源: 官方 · Vercel Labs
- 代码仓库: https://github.com/vercel-labs/agent-skills/tree/main/skills/deploy-to-vercel (commit dfeeb54 · v4.0.0)
- SKILL.md: https://github.com/vercel-labs/agent-skills/blob/main/skills/deploy-to-vercel/SKILL.md
- 安装命令: `npx skills add vercel-labs/agent-skills --skill deploy-to-vercel`
- 许可证: MIT
- 兼容工具: Any SKILL.md agent
- 权限: read-repo ✓, write-files ✓, shell ✓, network ✓
- 状态: 扫描通过
- 规则扫描无法覆盖所有风险，安装前请阅读此技能的 SKILL.md，确认权限后再使用。
- ⚠ 会把代码部署到 Vercel，经用户批准后可能 git add . 提交并推送，还可能全局安装 Vercel CLI。

## 核心规则

除非用户明确要求生产环境，否则一律部署为预览版本。

## 执行阶段

1. **收集项目状态** — 检查 git 远程、.vercel/ 关联文件、vercel whoami 登录状态和可用团队列表。
2. **选择团队** — 有多个团队时请用户选择，之后所有命令都带 --scope；已关联或只有一个团队则跳过。
3. **关联并部署** — 已关联且有远程时经用户同意后提交并推送；否则用 vercel link 关联后执行 vercel deploy，必要时先安装并登录 CLI。
4. **无登录兜底** — 无法登录时用 vercel deploy --temporary 创建临时部署，并告知用户认领链接和过期时间。
5. **返回部署链接** — 通过 vercel ls 或 vercel inspect 获取链接和构建状态告诉用户，不用 curl 去验证部署地址。

## 权限说明（据 SKILL.md 整理）

| 能力 | 是否需要 | 说明 |
|---|---|---|
| 文件写入 | 部分需要 | 通过 vercel link 生成 .vercel/ 关联文件，并在 git 推送部署时提交当前改动；不编辑应用代码。 |
| 命令执行 | 需要 | 运行 git、vercel CLI（whoami、link、deploy、inspect、ls）以及 npm install -g vercel 或 npx vercel。 |
| 网络外发 | 部分需要 | 仅连接 Vercel、npm 仓库和 git 远程；不会请求已部署的网址做验证。 |

## SKILL.md 头部信息（YAML）

```yaml
---
name: deploy-to-vercel
description: Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".
metadata:
  author: vercel
  version: "4.0.0"
---
```

首页: https://www.myskills.tools/zh/ · URL: https://www.myskills.tools/zh/skills/deploy-to-vercel/