vercel-deploy

Vercel Deploy 是一个面向 Vercel 平台的部署技能，用于将任意项目即时部署到 Vercel，且无需认证。当用户提出“部署我的应用”“把这个部署到生产环境”等部署类请求时，可以使用该技能。

主要能力

该技能会将项目打包为 tarball，打包时排除 node_modules 和 .git；随后从 package.json 自动检测框架，将包上传到部署服务，并返回两个链接：Preview URL（可访问的线上站点）和 Claim URL（用于把该部署转移到用户自己的 Vercel 账户）。

框架检测

脚本会从 package.json 自动识别框架，支持的框架包括：

React 相关：Next.js、Gatsby、Create React App、Remix、React Router
Vue 相关：Nuxt、Vitepress、Vuepress、Gridsome
Svelte 相关：SvelteKit、Svelte、Sapper
其他前端：Astro、Solid Start、Angular、Ember、Preact、Docusaurus
后端：Express、Hono、Fastify、NestJS、Elysia、h3、Nitro
构建工具：Vite、Parcel
以及更多：Blitz、Hydrogen、RedwoodJS、Storybook、Sanity 等

对于没有 package.json 的静态 HTML 项目，框架会被设为 null。

静态 HTML 项目

对于没有 package.json 的项目：如果存在一个未命名为 index.html 的单个 .html 文件，它会被自动重命名，以确保页面在根 URL（/）下被访问。

使用方式

通过 bash 脚本调用，传入要部署的路径参数：

bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]

参数说明：path 为要部署的目录，或一个 .tgz 文件（默认使用当前目录）。

示例：

部署当前目录

bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh

部署指定项目

bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project

部署已有的 tarball

bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh /path/to/project.tgz

输出

脚本会输出部署过程信息，例如：

Preparing deployment... Detected framework: nextjs Creating deployment package... Deploying... ✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app Claim URL: https://vercel.com/claim-deployment?code=...

脚本还会向 stdout 输出 JSON，供程序化使用：

{ "previewUrl": "https://skill-deploy-abc123.vercel.app", "claimUrl": "https://vercel.com/claim-deployment?code=...", "deploymentId": "dpl_...", "projectId": "prj_..." }

向用户展示结果

应始终同时展示两个 URL：

✓ Deployment successful!

Preview URL: https://skill-deploy-abc123.vercel.app Claim URL: https://vercel.com/claim-deployment?code=...

提示用户可通过 Preview URL 查看站点，通过 Claim URL 将该部署转移到自己的 Vercel 账户。

故障排查

网络出口错误：如果部署因网络限制而失败（在 claude.ai 上较常见），应告知用户：

Deployment failed due to network restrictions. To fix this:

Go to https://claude.ai/settings/capabilities
Add *.vercel.com to the allowed domains
Try deploying again

适用场景与限制

该技能适用于需要快速把前端、后端或静态站点部署到 Vercel 并获取预览链接的场景，尤其适合在对话式环境中直接触发部署。限制方面：部署依赖网络访问 Vercel 服务，在受限网络环境下可能失败；静态 HTML 项目仅处理单个 HTML 文件的重命名逻辑；关于收费、价格、配额等具体信息，资料中暂未提供。

技能介绍

部署当前目录

部署指定项目

部署已有的 tarball