К основному содержанию
скилл CX Codex

preview-environments-builder — скилл для Claude Code

Скилл preview-environments-builder генерирует пайплайны временных окружений для каждого пулл-реквеста с автоматическим развёртыванием, уникальным адресом и удалением ресурсов после закрытия PR.

MIT 250 установок ★ 64 обновлён 2026-01-12

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-code
Открыть на GitHub

Что делает preview-environments-builder

Скилл помогает настроить изолированные тестовые стенды под каждый пулл-реквест. Внутри содержатся готовые конфигурации GitHub Actions под Vercel и связку Docker с Kubernetes. Сценарии создают отдельное окружение, публикуют ссылку в комментарии к пулл-реквесту и удаляют ресурсы сразу после его закрытия.

В инструкции заложены правила генерации адресов, наполнение тестовой базы данных через psql и вызов скриптов вроде db:seed. Без корректных секретов репозитория вроде VERCEL_TOKEN или настроенного доступа к кластеру пайплайн сразу завершится ошибкой.

Какие задачи решает

  • развернуть изолированное превью-окружение для пулл-реквеста
  • настроить автоматическую отправку ссылки на стенд в комментарии PR
  • настроить удаление ресурсов и пространств имён после закрытия пулл-реквеста
  • подготовить тестовую базу данных для временного контура

Примеры запросов агенту

  • Настрой GitHub Actions для деплоя превью в Vercel на каждый PR
  • Сделай воркфлоу развёртывания временного стенда в Kubernetes с удалением после закрытия PR
  • Добавь шаг создания и наполнения тестовой базы данных для превью-окружения

Как установить preview-environments-builder

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-code

2Вручную: положить файлы

~/.claude/skills/preview-environments-builder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/preview-environments-builder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о preview-environments-builder

Как установить preview-environments-builder в Claude Code?

Выполните команду npx skills add patricio0312rev/skills --skill preview-environments-builder -a claude-code.

Что делает preview-environments-builder?

Он предоставляет шаблоны GitHub Actions для запуска временных тестовых окружений на Vercel или Kubernetes под каждый пулл-реквест.

Как происходит очистка ресурсов после завершения работы?

Сценарий отслеживает закрытие пулл-реквеста и удаляет деплоймент в Vercel либо очищает пространство имён в Kubernetes.

Исходный текст

SKILL.md · MIT
---
name: preview-environments-builder
description: Creates ephemeral preview deployments for each pull request with automatic deployment, unique URLs, and cleanup on PR close. Use for "preview deployments", "PR environments", "ephemeral environments", or "review apps".
---

# Preview Environments Builder

Deploy isolated preview environments for every pull request.

## Vercel Preview Deployment

```yaml
# .github/workflows/preview.yml
name: Preview Deployment

on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  deploy-preview:
    runs-on: ubuntu-latest
    environment:
      name: preview-${{ github.event.pull_request.number }}
      url: ${{ steps.deploy.outputs.url }}

    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: "20"
          cache: "npm"

      - run: npm ci
      - run: npm run build

      - name: Deploy to Vercel
        id: deploy
        uses: amondnet/vercel-action@v25
        with:
          vercel-token: ${{ secrets.VERCEL_TOKEN }}
          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
          scope: ${{ secrets.VERCEL_ORG_ID }}
          alias-domains: pr-${{ github.event.pull_request.number }}.myapp.dev

      - name: Comment PR
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: `✅ Preview deployed!\n\n🔗 **URL:** ${{ steps.deploy.outputs.url }}\n\nCommit: ${context.sha.substring(0, 7)}`
            })
```

## Docker-based Preview

```yaml
preview:
  runs-on: ubuntu-latest
  steps:
    - uses: actions/checkout@v4

    - name: Build Docker image
      run: |
        docker build -t myapp:pr-${{ github.event.pull_request.number }} .

    - name: Deploy to Kubernetes
      run: |
        kubectl create namespace pr-${{ github.event.pull_request.number }} || true
        kubectl apply -f k8s/preview.yml \
          --namespace pr-${{ github.event.pull_request.number }}
        kubectl set image deployment/myapp \
          myapp=myapp:pr-${{ github.event.pull_request.number }} \
          --namespace pr-${{ github.event.pull_request.number }}

    - name: Get preview URL
      id: url
      run: |
        URL=$(kubectl get ingress myapp \
          --namespace pr-${{ github.event.pull_request.number }} \
          -o jsonpath='{.status.loadBalancer.ingress[0].hostname}')
        echo "url=https://pr-${{ github.event.pull_request.number }}.preview.myapp.com" >> $GITHUB_OUTPUT

    - name: Comment PR
      uses: actions/github-script@v7
      with:
        script: |
          github.rest.issues.createComment({
            issue_number: context.issue.number,
            owner: context.repo.owner,
            repo: context.repo.repo,
            body: `🚀 Preview deployed to: ${{ steps.url.outputs.url }}`
          })
```

## Cleanup on PR Close

```yaml
# .github/workflows/cleanup-preview.yml
name: Cleanup Preview

on:
  pull_request:
    types: [closed]

jobs:
  cleanup:
    runs-on: ubuntu-latest
    steps:
      - name: Delete Vercel deployment
        uses: actions/github-script@v7
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          script: |
            const deployments = await github.rest.repos.listDeployments({
              owner: context.repo.owner,
              repo: context.repo.repo,
              environment: `preview-${context.issue.number}`
            });

            for (const deployment of deployments.data) {
              await github.rest.repos.createDeploymentStatus({
                owner: context.repo.owner,
                repo: context.repo.repo,
                deployment_id: deployment.id,
                state: 'inactive'
              });

              await github.rest.repos.deleteDeployment({
                owner: context.repo.owner,
                repo: context.repo.repo,
                deployment_id: deployment.id
              });
            }

      - name: Cleanup Kubernetes namespace
        run: |
          kubectl delete namespace pr-${{ github.event.pull_request.number }} --ignore-not-found=true
```

## Environment Naming

```yaml
# Consistent naming pattern
environment:
  name: preview-pr-${{ github.event.pull_request.number }}
  url: https://pr-${{ github.event.pull_request.number }}.preview.myapp.com
```

## Database Seeding

```yaml
- name: Setup preview database
  run: |
    # Create database
    psql -c "CREATE DATABASE preview_pr_${{ github.event.pull_request.number }};"

    # Seed with test data
    npm run db:seed -- --database=preview_pr_${{ github.event.pull_request.number }}
  env:
    DATABASE_URL: ${{ secrets.PREVIEW_DB_URL }}
```

## Best Practices

1. **Unique URLs**: pr-{number}.preview.domain.com
2. **Auto cleanup**: Delete on PR close
3. **Comment on PR**: Link to preview
4. **Environment protection**: Require approval
5. **Resource limits**: Prevent abuse
6. **TTL**: Auto-delete after 7 days
7. **Secrets management**: Use preview-specific secrets

## Output Checklist

- [ ] Preview deployment workflow
- [ ] Unique URL generation
- [ ] PR comment with link
- [ ] Cleanup workflow on close
- [ ] Environment naming strategy
- [ ] Database seeding (if needed)
- [ ] Resource limits configured

© patricio0312rev · MIT · patricio0312rev/skills

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
devops-engineer https://github.com/Jeffallan Скилл devops-engineer для Claude Code создаёт Dockerfile, CI/CD-конфигурации и манифесты Kubernetes. Решает задачи инфраструктуры, деплоя и разбора инцидентов. CX Codex +1 12 400установок deployment-engineer zhaono1 Скилл deployment-engineer настраивает пайплайны CI/CD, готовит конфигурации релизов и стратегии отката. Защищает прод: агент не запустит деплой без явного подтверждения. CX Codex +1 685установок gear simota Скилл gear настраивает CI/CD в GitHub Actions, контейнеры Docker, зависимости и секреты. Помогает починить сборку или закрыть бреши в цепочке поставок. CX Codex +1 164установок github-actions-templates Seth Hobson Скилл github-actions-templates для Claude Code создаёт GitHub Actions для тестирования, сборки и деплоя. Настраивает CI/CD и reusable workflows. CX Codex +1 17 420установок devops-cicd miles990 Скилл devops-cicd для Claude Code собирает пайплайны, описывает инфраструктуру кодом и помогает выбрать стратегию деплоя. Включается на задачах про DevOps, CI/CD и деплой. CX Codex +1 610установок devops-infrastructure CloudAI-X Скилл devops-infrastructure для Claude Code пишет Dockerfile, настраивает GitHub Actions, планирует развёртывания и организует мониторинг. Используется при контейнеризации, работе с пайплайнами, Terraform и production-инфраструктурой. CX Codex +1 ★ 1 424звёзд репо

Из того же набора148

Весь набор →
test-reporting-triage-skill Скилл test-reporting-triage-skill для Claude Code группирует ошибки тестов по категориям, предлагает ответственные команды и варианты исправления. Разбирает результаты прогона тестов. CX Codex +1 257установок mocking-assistant Скилл mocking-assistant помогает создавать моки для API, сервисов и UI через MSW и Vitest: от фикстур данных до перехвата системного времени в тестах. CX Codex +1 256установок service-layer-extractor Скилл service-layer-extractor выносит бизнес-логику из контроллеров в сервисы и репозитории. Помогает навести порядок в раздутых роутах и подготовить код к юнит-тестам. CX Codex +1 255установок rag-pipeline-builder Скилл rag-pipeline-builder проектирует RAG-пайплайн для ассистента по документам: чанкинг, метаданные, гибридный поиск, реранкинг и план оценки качества. CX Codex +1 251установок load-test-scenario-builder Скилл load-test-scenario-builder проектирует сценарии нагрузочного тестирования, готовит k6-скрипты, профили трафика и критерии успеха для проверки пропускной способности. CX Codex +1 236установок graphql-schema-designer Скилл graphql-schema-designer для Claude Code помогает спроектировать GraphQL API с типами, запросами, мутациями, подписками и резолверами. Включается по запросам о схеме, настройке GraphQL или Apollo Server. CX Codex +1 230установок test-data-factory-builder Скилл test-data-factory-builder для Claude Code создаёт фабрики и билдеры тестовых данных. Подключается к запросам на генерацию фикстур, тестовых сущностей и связанных записей. CX Codex +1 229установок terraform-module-builder Скилл terraform-module-builder помогает проектировать переиспользуемые модули Terraform с валидацией входных переменных, outputs и структурой каталогов. CX Codex +1 229установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой