Deploy to Vercel

Задеплойте любой проект на Vercel. Всегда деплойте как preview (не production), если пользователь явно не попросит production.

Цель — настроить наилучшее долгосрочное решение: проект связан с Vercel и деплоится по git push. Каждый из описанных методов приближает к этому состоянию.

Шаг 1: Сбор информации о проекте

Выполните все четыре проверки перед выбором метода деплоя:

# 1. Проверить наличие git remote
git remote get-url origin 2>/dev/null

# 2. Проверить локальную привязку к проекту Vercel
cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null

# 3. Проверить, установлен ли и аутентифицирован Vercel CLI
vercel whoami 2>/dev/null

# 4. Список доступных команд (если аутентифицирован)
vercel teams list --format json 2>/dev/null

Если пользователь состоит в нескольких командах — покажите все слаги командой и спросите, в какую деплоить. Передавайте слаг через --scope во всех последующих CLI-командах:

vercel deploy [path] -y --no-wait --scope <team-slug>

Шаг 2: Выбор метода деплоя

Есть .vercel/ + есть git remote → Git Push

Идеальное состояние: проект привязан и интегрирован с git.

1. Спросите разрешение пользователя перед push.  Никогда не пушьте без явного подтверждения.
2. Зафиксируйте и отправьте изменения:

   git add .
   git commit -m "deploy: <описание изменений>"
   git push

3. Получите URL preview через vercel ls --format json (поле url последнего деплоя).

Есть .vercel/ + нет git remote → vercel deploy

vercel deploy [path] -y --no-wait

Флаг --no-wait возвращает URL сразу, не дожидаясь завершения сборки. Статус деплоя можно проверить командой:

vercel inspect <deployment-url>

Для production (только по явной просьбе): добавьте флаг --prod.

Нет привязки + CLI аутентифицирован → Привязать, затем задеплоить

1. Выберите команду (скип, если одна).
2. Привяжите проект (предпочтительно с --repo, если есть git remote):

   vercel link --repo --scope <team-slug>   # при наличии git remote
   vercel link --scope <team-slug>          # без git remote

3. Задеплойте: через git push (если есть remote) или vercel deploy -y --no-wait.

Нет привязки + CLI не аутентифицирован → Установить, войти, привязать, задеплоить

npm install -g vercel
vercel login

Затем выберите команду, привяжите проект и задеплойте как в предыдущем разделе.

Запасной вариант без аутентификации — sandbox claude.ai

Последнее средство, когда CLI нельзя установить или аутентифицировать. Не требует аутентификации — возвращает Preview URL и Claim URL.

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

# Задеплоить текущую директорию
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh

# Задеплоить конкретный проект
bash /mnt/skills/user/deploy-to-vercel/resources/deploy.sh /path/to/project

Скрипт автоматически определяет фреймворк из package.json, упаковывает проект (исключая node_modules, .git, .env), загружает и ждёт завершения сборки.

Сообщите пользователю: «Ваш деплой готов по адресу [previewUrl]. Подтвердите права по ссылке [claimUrl], чтобы управлять деплоем.»

Запасной вариант без аутентификации — sandbox Codex

1. Проверьте наличие CLI: command -v vercel
2. Если установлен — попробуйте: vercel deploy [path] -y --no-wait
3. Если не установлен или ошибка «No existing credentials found» — используйте запасной скрипт: bash "$skill_dir/resources/deploy-codex.sh"

Примечания для конкретных агентов

• Claude Code / терминальные агенты: полный доступ к shell. Не используйте путь /mnt/skills/. Для запасного варианта: bash ~/.claude/skills/deploy-to-vercel/resources/deploy.sh
• Sandbox environments (claude.ai): vercel login и git push, как правило, недоступны. Сразу переходите к запасному варианту claude.ai.
• Codex: работает в sandbox. Сначала попробуйте CLI, затем — запасной скрипт Codex.

Вывод результата

Всегда показывайте пользователю URL деплоя. Для запасного варианта без аутентификации показывайте оба URL:

Деплой успешен!

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

Откройте сайт по Preview URL.
Чтобы перенести деплой на свой аккаунт Vercel, перейдите по Claim URL.

Не делайте curl или fetch к задеплоенному URL для проверки. Просто верните ссылку.

Устранение неполадок

Ошибка Network Egress (claude.ai)

Если деплой завершился неудачей из-за сетевых ограничений — сообщите пользователю добавить *.vercel.com в разрешённые домены в настройках claude.ai.

Ошибка аутентификации CLI

Если vercel login или vercel deploy завершается с ошибкой аутентификации — переключитесь на запасной скрипт деплоя (вариант claude.ai или Codex в зависимости от окружения).