Back to Details

vercel-deploy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Vercel Deploy

Vercel 部署

Deploy any project to Vercel instantly. No authentication required.
可将任意项目即时部署到Vercel，无需身份验证。

When to use this skill

何时使用此Skill

  • 앱 배포: "Deploy my app" 요청 시
  • 프리뷰 배포: "Create a preview deployment" 요청 시
  • 프로덕션 배포: "Deploy this to production" 요청 시
  • 링크 공유: "Deploy and give me the link" 요청 시
  • 应用部署：收到“Deploy my app”请求时
  • 预览部署：收到“Create a preview deployment”请求时
  • 生产环境部署：收到“Deploy this to production”请求时
  • 链接分享：收到“Deploy and give me the link”请求时

How It Works

工作原理

  1. Packages your project into a tarball (excludes 
    node_modules
    and 
    .git
    )
  2. Auto-detects framework from 
    package.json
  3. Uploads to deployment service
  4. Returns Preview URL (live site) and Claim URL (transfer to your Vercel account)
  1. 将你的项目打包为tarball（排除
    node_modules
    和
    .git
    目录）
  2. 从
    package.json
    中自动检测框架
  3. 上传至部署服务
  4. 返回预览URL（可即时访问的在线站点）和认领URL（转移至你的Vercel账户）

Instructions

使用说明

Step 1: 프로젝트 준비

步骤1：项目准备

배포할 프로젝트 디렉토리를 확인합니다.
지원 프레임워크:
  • React: Next.js, Gatsby, Create React App, Remix, React Router
  • Vue: Nuxt, Vitepress, Vuepress, Gridsome
  • Svelte: SvelteKit, Svelte, Sapper
  • Other Frontend: Astro, Solid Start, Angular, Ember, Preact, Docusaurus
  • Backend: Express, Hono, Fastify, NestJS, Elysia, h3, Nitro
  • Build Tools: Vite, Parcel
  • And more: Blitz, Hydrogen, RedwoodJS, Storybook, Sanity, etc.
确认要部署的项目目录。
支持的框架:
  • 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, etc.

Step 2: 배포 실행

步骤2：执行部署

스크립트 사용 (claude.ai 환경):
bash
bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
Arguments:
  • path
    - Directory to deploy, or a 
    .tgz
    file (defaults to current directory)
Examples:
bash
undefined
使用脚本（claude.ai环境）:
bash
bash /mnt/skills/user/vercel-deploy/scripts/deploy.sh [path]
参数说明:
  • path
    - 要部署的目录或
    .tgz
    文件（默认值为当前目录）
示例:
bash
undefined

Deploy current directory

部署当前目录

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

Deploy specific project

部署指定项目

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

Deploy existing tarball

部署现有压缩包

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

Step 3: 결과 확인

步骤3：查看结果

배포 성공 시 두 개의 URL이 반환됩니다:
  • Preview URL: 즉시 접근 가능한 라이브 사이트
  • Claim URL: Vercel 계정으로 배포 이전
部署成功后会返回两个URL：
  • 预览URL：可即时访问的在线站点
  • 认领URL：转移至你的Vercel账户

Output Format

输出格式

콘솔 출력

控制台输出

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=...
正在准备部署...
已检测到框架：nextjs
正在创建部署包...
正在部署...
✓ 部署成功！

预览URL: https://skill-deploy-abc123.vercel.app
认领URL:   https://vercel.com/claim-deployment?code=...

JSON 출력 (프로그래밍 용)

JSON输出（编程用）

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

Static HTML Projects

静态HTML项目

For projects without a 
package.json
:
  • If there's a single 
    .html
    file not named 
    index.html
    , it gets renamed automatically
  • This ensures the page is served at the root URL (
    /
    )
对于没有
package.json
的项目：
  • 如果只有一个非
    index.html
    的
    .html
    文件，会自动重命名
  • 确保页面可通过根URL (
    /
    ) 访问

Present Results to User

向用户展示结果

Always show both URLs:
✓ Deployment successful!

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

View your site at the Preview URL.
To transfer this deployment to your Vercel account, visit the Claim URL.
务必同时展示两个URL：
✓ 部署成功！

预览URL: https://skill-deploy-abc123.vercel.app
认领URL:   https://vercel.com/claim-deployment?code=...

请通过预览URL访问你的站点。
如需将此部署转移至你的Vercel账户，请访问认领URL。

Troubleshooting

故障排查

Network Egress Error

网络出口错误

If deployment fails due to network restrictions (common on claude.ai), tell the user:
Deployment failed due to network restrictions. To fix this:

1. Go to https://claude.ai/settings/capabilities
2. Add *.vercel.com to the allowed domains
3. Try deploying again
如果因网络限制导致部署失败（在claude.ai环境中常见），请告知用户：
部署因网络限制失败。解决方法：

1. 访问 https://claude.ai/settings/capabilities
2. 将 *.vercel.com 添加至允许的域名列表
3. 重新尝试部署

Framework Not Detected

未检测到框架

프레임워크가 감지되지 않으면:
  1. package.json
    존재 여부 확인
  2. dependencies에 프레임워크 패키지 포함 확인
  3. 수동으로 
    framework
    파라미터 지정
如果未检测到框架：
  1. 检查是否存在
    package.json
    文件
  2. 检查dependencies中是否包含框架包
  3. 手动指定
    framework
    参数

Constraints

约束条件

필수 규칙 (MUST)

必须遵守的规则（MUST）

  1. 두 URL 모두 표시: Preview URL과 Claim URL 모두 사용자에게 표시
  2. 프레임워크 감지: package.json에서 자동 감지
  3. 에러 메시지 표시: 배포 실패 시 명확한 에러 메시지
  1. 展示两个URL：必须向用户同时展示预览URL和认领URL
  2. 框架检测：从package.json中自动检测框架
  3. 错误消息展示：部署失败时显示明确的错误消息

금지 사항 (MUST NOT)

禁止事项（MUST NOT）

  1. node_modules 포함: tarball에 node_modules 포함하지 않음
  2. .git 포함: tarball에 .git 디렉토리 포함하지 않음
  3. 인증 정보 하드코딩: 인증 필요 없음 (claimable deploy)
  1. 禁止包含node_modules：压缩包中不得包含node_modules目录
  2. 禁止包含.git：压缩包中不得包含.git目录
  3. 禁止硬编码认证信息：无需认证（支持可认领部署）

Best practices

最佳实践

  1. 프레임워크 자동 감지: package.json 분석으로 최적 설정
  2. Clean Tarball: node_modules, .git 제외로 빠른 업로드
  3. 명확한 출력: Preview URL과 Claim URL 구분 표시
  1. 自动检测框架：通过分析package.json获取最优配置
  2. 精简压缩包：排除node_modules和.git以实现快速上传
  3. 清晰输出：区分展示预览URL和认领URL

References

参考资料

Metadata

元数据

버전

版本

  • 현재 버전: 1.0.0
  • 최종 업데이트: 2026-01-22
  • 호환 플랫폼: Claude (claude.ai)
  • 원본 출처: vercel/agent-skills
  • 当前版本: 1.0.0
  • 最后更新: 2026-01-22
  • 兼容平台: Claude (claude.ai)
  • 原始来源: vercel/agent-skills

관련 스킬

相关技能

  • deployment-automation: CI/CD 및 Docker/K8s 배포
  • deployment-automation：CI/CD及Docker/K8s部署

태그

标签

#deployment
#vercel
#preview
#production
#hosting
#serverless
#infrastructure
#部署
#vercel
#预览
#生产环境
#托管
#无服务器
#基础设施