Vercel Platform

核心用法

Vercel 技能提供完整的 CLI 命令参考与官方文档访问能力，覆盖从代码到生产的全链路 DevOps 操作。

部署流程：vercel 命令一键部署当前目录，支持 --prod 直达生产环境；vercel build 本地构建后配合 --prebuilt 实现可复现部署；vercel dev 启动本地开发服务器，与生产环境行为一致。

项目管理：vercel link 关联本地与云端项目，vercel pull 同步环境变量与配置，vercel projects 系列命令完成增删改查。环境变量通过 vercel env 分级管理（development/preview/production），支持敏感配置安全注入。

运维监控：vercel logs 实时查看运行时日志（支持 JSON 输出与 jq 过滤），vercel promote/rollback/redeploy 实现部署版本灵活调度，vercel bisect 二分定位问题提交。

基础设施：vercel domains 管理域名与购买/转入，vercel alias 配置部署别名，vercel certs/dns 处理 SSL 证书与 DNS 记录。内置 curl 接口可直接拉取官方文档为 Markdown，便于离线查阅。

显著优点

• 零配置体验：Git 集成自动检测框架，Next.js、SvelteKit、Nuxt 等开箱即用
• 边缘网络原生：部署自动分发至全球 CDN，无需额外配置
• 开发/生产一致性：vercel dev 模拟生产运行时，减少环境差异 Bug
• 团队协作友好：多 scope 切换、团队权限管理、环境变量分级隔离
• 文档即服务：curl 直接获取官方 Markdown 文档，AI 场景友好

潜在局限

• 平台锁定：深度依赖 Vercel 运行时与边缘函数，迁移成本较高
• 服务端限制：Node.js 运行时受限于边缘环境，部分原生模块不可用
• 成本曲线：流量与构建时长超出免费额度后费用显著增长
• 企业合规：部分行业对数据驻留有严格要求，需评估区域节点覆盖

适合人群

前端/全栈开发者、初创团队技术负责人、需要快速 MVP 验证的产品团队、Next.js 生态深度用户。

常规风险

• 环境变量误配置可能导致生产数据泄露
• vercel --prod 覆盖部署无二次确认，需配合 CI/CD 审批流
• 第三方集成权限过度授予可能暴露团队资源
• 免费账户构建并发数受限，高峰期排队等待

核心用法

Vercel 是全球领先的前端云部署平台，本 Skill 提供其官方 CLI 的完整命令参考，采用纯文档型架构（T-MD 分类），零代码执行风险。

核心能力矩阵

| 场景 | 关键命令 |

|------|---------|

| 快速部署 | `vercel` / `vercel --prod` |

| 本地开发 | `vercel dev --listen 8080` |

| 项目管理 | `vercel link` / `vercel projects list` |

| 环境变量 | `vercel env add KEY production` / `vercel env pull` |

| 域名绑定 | `vercel domains add custom.com my-project` |

| 部署回滚 | `vercel rollback` / `vercel promote <id>` |

| 日志追踪 | `vercel logs <url> --json \| jq` |

| 文档查询 | `curl vercel.com/docs/<path> -H 'accept: text/markdown'` |

工作流最佳实践

预构建部署模式（推荐用于 CI/CD）：

vercel build              # 本地构建到 ./vercel/output
vercel --prebuilt --prod  # 直接上传产物，跳过云端构建

多环境管理：

• development：本地 dev 服务器自动注入
• preview：Git 推送后的临时部署
• production：--prod 标志或主干分支自动部署

显著优点

1. 零学习成本：纯文档型 Skill，无抽象层，命令与官方 CLI 1:1 对应
2. 实时文档同步：内置 curl 接口直接拉取 Vercel 官方文档，避免版本滞后
3. 全生命周期覆盖：从 init 初始化到 bisect 二分排查问题部署，覆盖完整 DevOps 链路
4. 安全隔离：不存储 API Token，不执行任何代码，所有敏感操作仍由用户本地 vercel login 后的 CLI 处理

潜在局限

• 依赖本地 CLI：需用户已安装 vercel 二进制文件，Skill 本身不替代 CLI
• 无交互式向导：纯命令速查，不提供 step-by-step 引导
• T3 来源等级：个人开发者维护（thesethrose），非 Vercel 官方出品，需自行验证命令准确性
• 文档网络依赖：实时文档获取需连接 vercel.com，离线环境不可用

适合人群

• 已熟悉 Vercel 平台、需要快速查询命令细节的中高级开发者
• 在终端环境工作、偏好 CLI 而非 Dashboard 的运维工程师
• 构建内部 CI/CD 模板、需要标准命令参考的技术团队

常规风险

| 风险类型 | 说明 | 缓解措施 |

|---------|------|---------|

| 命令误操作 | 如误执行 `vercel rm` 删除生产部署 | Skill 仅展示文档，实际执行需用户确认；建议搭配 `--yes` 标志警示 |

| Token 泄露 | Skill 不处理 Token，但用户可能在命令行暴露 `-t <TOKEN>` | 使用 `vercel login` 替代手动 Token，利用 CLI 的加密存储 |

| 来源可信度 | T3 级个人项目，无 Vercel 官方背书 | 关键命令执行前交叉核对 [vercel.com/docs/cli](https://vercel.com/docs/cli) |

---

安全评级：S（优秀） — 通过 CLS-Certify 六维检测，纯 Markdown 架构，无可执行代码，零依赖，零数据收集。