技能介绍

要解决什么问题

在 Agent 或沙箱环境里帮用户「把项目部署到 Vercel」，常见障碍是：还没登录 Vercel、本地没有配置 token，或者你只想先拿到一个可访问的预览地址，再决定是否把站点迁到自己的账号。这个技能走一条无需身份验证的部署路径：打包、上传、返回链接，而不是假设用户已经完成 OAuth 或 CLI 登录。

工作原理与核心能力

将指定目录（或现成的 .tgz）打成 tarball，默认会排除 node_modules 与 .git，减小上传体积。
从 package.json 自动检测框架（Next.js、Nuxt、Vite、Express 等一长串生态；无 package.json 的纯静态站会按静态 HTML 规则处理）。
上传到部署服务后，输出两类 URL：预览 URL（立即可访问的在线站点）与认领 URL（把该部署转移到用户自己的 Vercel 账户）。
脚本还会向标准输出打印 JSON，便于在自动化流程里解析预览与认领地址。

向用户展示结果时，应始终同时给出预览与认领两个链接，避免只给预览却漏掉所有权转移入口。

适用边界与注意点

参数：path 为要部署的目录或 .tgz 文件，省略时一般为当前工作目录。
纯静态 HTML、且没有 package.json 时，若存在单个非 index.html 的页面文件，可能会自动重命名，以保证根路径 / 能正确提供页面。
在 网络出口受限 的环境（例如部分 claude.ai 运行环境）上传可能失败，需要向用户说明是出口限制而非项目配置错误，并建议在本机或网络可达的环境重试。