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

rollback-workflow-builder — скилл для Claude Code: откат

Скилл rollback-workflow-builder для Claude Code собирает процедуры отката деплоя: GitHub Actions, runbook и проверку восстановления. Описывает ручной и автоматический откат при сбое production.

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

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

Что делает rollback-workflow-builder

Скилл проектирует ручной и автоматический откат деплоя. Он предлагает workflow для GitHub Actions с выбором версии, окружения и причины, проверкой существования версии, сборкой через npm ci и npm run build, деплоем и health check. После отката workflow создаёт issue с деталями инцидента.

В материалах есть отдельные схемы для Kubernetes, Docker-образов и отката миграций базы данных. Runbook описывает проверку текущей версии, выбор последней рабочей версии, уведомление команды, ручной сценарий через ssh, docker pull и docker-compose, а также проверку API и логов.

Показанный workflow использует DEPLOY_TOKEN, scripts/deploy.sh и scripts/health-check.sh, поэтому без этих секретов и скриптов пример не запустится как есть.

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

  • собрать ручной workflow для отката версии
  • запускать автоматический rollback после сбоя деплоя
  • проверить восстановление через health check
  • откатить Kubernetes deployment к прошлой ревизии
  • вернуть миграцию базы данных к целевому состоянию

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

  • Собери workflow GitHub Actions для ручного отката в staging и production с выбором версии и причиной инцидента.
  • Добавь автоматический rollback, если scripts/deploy.sh или scripts/health-check.sh завершается с ошибкой.
  • Составь runbook для отката Docker-образа и проверь шаги через docker-compose.

Как установить rollback-workflow-builder

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill rollback-workflow-builder -a claude-code

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

~/.claude/skills/rollback-workflow-builder/SKILL.md

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

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

Вопросы о rollback-workflow-builder

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

Выполните npx skills add patricio0312rev/skills --skill rollback-workflow-builder -a claude-code, затем проверьте файл ~/.claude/skills/rollback-workflow-builder/SKILL.md.

Что делает rollback-workflow-builder?

Скилл помогает описать ручной и автоматический rollback для деплоя, добавить проверки версии и состояния сервиса, а также оформить runbook для инцидента.

Какие сценарии отката он охватывает?

В материалах есть примеры для GitHub Actions, Kubernetes, Docker-образов и миграций базы данных. Отдельно показан выпуск issue с деталями rollback.

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

SKILL.md · MIT
---
name: rollback-workflow-builder
description: Creates safe rollback procedures for deployments with automated workflows, rollback runbooks, version management, and incident response. Use for "rollback automation", "deployment recovery", "incident response", or "production rollback".
---

# Rollback Workflow Builder

Build safe, fast rollback mechanisms for production deployments.

## Manual Rollback Workflow

```yaml
# .github/workflows/rollback.yml
name: Rollback

on:
  workflow_dispatch:
    inputs:
      version:
        description: "Version to rollback to (e.g., v1.2.3 or previous)"
        required: true
        type: string
      environment:
        description: "Environment to rollback"
        required: true
        type: choice
        options:
          - staging
          - production
      reason:
        description: "Reason for rollback"
        required: true
        type: string

jobs:
  rollback:
    runs-on: ubuntu-latest
    environment: ${{ github.event.inputs.environment }}
    steps:
      - uses: actions/checkout@v4
        with:
          ref: ${{ github.event.inputs.version }}

      - name: Verify version exists
        run: |
          if ! git rev-parse ${{ github.event.inputs.version }} >/dev/null 2>&1; then
            echo "❌ Version ${{ github.event.inputs.version }} not found"
            exit 1
          fi
          echo "✅ Version ${{ github.event.inputs.version }} exists"

      - name: Get current version
        id: current
        run: |
          CURRENT=$(git describe --tags --abbrev=0)
          echo "version=$CURRENT" >> $GITHUB_OUTPUT
          echo "Current version: $CURRENT"

      - name: Confirm rollback
        run: |
          echo "🔄 Rolling back from ${{ steps.current.outputs.version }} to ${{ github.event.inputs.version }}"
          echo "Environment: ${{ github.event.inputs.environment }}"
          echo "Reason: ${{ github.event.inputs.reason }}"

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

      - run: npm ci
      - run: npm run build

      - name: Deploy rollback
        run: |
          ./scripts/deploy.sh ${{ github.event.inputs.environment }}
        env:
          DEPLOY_TOKEN: ${{ secrets.DEPLOY_TOKEN }}

      - name: Verify deployment
        run: |
          ./scripts/health-check.sh ${{ github.event.inputs.environment }}

      - name: Create incident issue
        uses: actions/github-script@v7
        with:
          script: |
            github.rest.issues.create({
              owner: context.repo.owner,
              repo: context.repo.repo,
              title: `Rollback: ${context.payload.inputs.environment} to ${context.payload.inputs.version}`,
              body: `## Rollback Details

              **Environment:** ${context.payload.inputs.environment}
              **From:** ${{ steps.current.outputs.version }}
              **To:** ${context.payload.inputs.version}
              **Reason:** ${context.payload.inputs.reason}
              **Triggered by:** @${context.actor}
              **Time:** ${new Date().toISOString()}

              ## Next Steps
              - [ ] Verify rollback successful
              - [ ] Investigate root cause
              - [ ] Create fix
              - [ ] Update postmortem
              `,
              labels: ['incident', 'rollback']
            })
```

## Automated Rollback on Failure

```yaml
deploy:
  runs-on: ubuntu-latest
  steps:
    - name: Deploy
      id: deploy
      run: ./scripts/deploy.sh production
      continue-on-error: true

    - name: Verify deployment
      id: verify
      if: steps.deploy.outcome == 'success'
      run: ./scripts/health-check.sh production
      continue-on-error: true

    - name: Auto-rollback on failure
      if: steps.deploy.outcome == 'failure' || steps.verify.outcome == 'failure'
      run: |
        echo "⚠️ Deployment failed, initiating automatic rollback"
        PREVIOUS_VERSION=$(git describe --tags --abbrev=0 HEAD^)
        ./scripts/deploy.sh production $PREVIOUS_VERSION

        # Verify rollback
        if ./scripts/health-check.sh production; then
          echo "✅ Rollback successful"
        else
          echo "❌ Rollback failed - manual intervention required"
          exit 1
        fi
```

## Kubernetes Rollback

```yaml
rollback-k8s:
  runs-on: ubuntu-latest
  steps:
    - name: Setup kubectl
      uses: azure/setup-kubectl@v3

    - name: Configure kubectl
      run: |
        echo "${{ secrets.KUBECONFIG }}" > kubeconfig
        export KUBECONFIG=kubeconfig

    - name: Rollback deployment
      run: |
        kubectl rollout undo deployment/myapp -n production
        kubectl rollout status deployment/myapp -n production --timeout=5m

    - name: Get rollback revision
      run: |
        kubectl rollout history deployment/myapp -n production
```

## Docker Image Rollback

```yaml
- name: Rollback to previous image
  run: |
    # Get previous image tag
    PREVIOUS_TAG=$(docker inspect myapp:latest | jq -r '.[0].ContainerConfig.Labels.previous_tag')

    # Retag previous as latest
    docker pull myapp:$PREVIOUS_TAG
    docker tag myapp:$PREVIOUS_TAG myapp:latest
    docker push myapp:latest

    # Restart containers
    docker-compose pull
    docker-compose up -d
```

## Database Migration Rollback

```yaml
- name: Rollback database migrations
  run: |
    # Get migration to rollback to
    CURRENT=$(npm run migrate:current)
    TARGET=${{ github.event.inputs.migration }}

    echo "Rolling back from $CURRENT to $TARGET"
    npm run migrate:down -- --to=$TARGET

    # Verify rollback
    AFTER=$(npm run migrate:current)
    if [ "$AFTER" != "$TARGET" ]; then
      echo "❌ Migration rollback failed"
      exit 1
    fi
  env:
    DATABASE_URL: ${{ secrets.DATABASE_URL }}
```

## Rollback Runbook

````markdown
# Production Rollback Runbook

## When to Rollback

Rollback if:

- Critical bugs affecting >10% of users
- Data integrity issues
- Security vulnerabilities
- Performance degradation >50%
- Error rate >5%

## Before Rollback

1. **Assess impact**: Check monitoring dashboards
2. **Identify version**: Determine last known good version
3. **Notify team**: Post in #incidents Slack channel
4. **Enable maintenance mode** (if possible)

## Rollback Steps

### Automated Rollback (Preferred)

1. Go to Actions → Rollback workflow
2. Select environment (staging/production)
3. Enter target version (e.g., v1.2.3 or "previous")
4. Enter reason for rollback
5. Click "Run workflow"
6. Monitor progress in Actions tab

### Manual Rollback (Emergency)

```bash
# 1. SSH to production server
ssh production

# 2. Check current version
docker ps | grep myapp

# 3. Pull previous version
docker pull myapp:v1.2.3

# 4. Update docker-compose
vim docker-compose.yml
# Change image: myapp:latest to myapp:v1.2.3

# 5. Deploy
docker-compose up -d

# 6. Verify
curl https://api.myapp.com/health

# 7. Check logs
docker logs myapp -f
```
````

## After Rollback

1. **Verify**: Run smoke tests
2. **Monitor**: Watch error rates for 15 minutes
3. **Notify**: Update #incidents with status
4. **Disable maintenance mode**
5. **Create incident ticket**
6. **Schedule postmortem**

## Rollback Verification

- [ ] Health check returns 200
- [ ] Error rate <1%
- [ ] Response time p95 <500ms
- [ ] Key features working (login, checkout, etc.)
- [ ] Database connectivity OK

## Communication Template

```
🔄 ROLLBACK IN PROGRESS

Environment: Production
From: v1.3.0
To: v1.2.3
Reason: Critical bug in checkout flow
Status: In progress
ETA: 5 minutes

Updates: #incidents
```

## Common Issues

### Issue: Rollback Fails

**Symptom:** Deployment doesn't start
**Fix:** Check logs, verify version exists, ensure secrets are valid

### Issue: Database Incompatibility

**Symptom:** App starts but can't read data
**Fix:** May need to rollback migrations first

### Issue: Traffic Not Routing

**Symptom:** Users still see new version
**Fix:** Clear CDN cache, check load balancer config

````

## Health Check Script

```bash
#!/bin/bash
# scripts/health-check.sh

ENVIRONMENT=$1
BASE_URL="https://${ENVIRONMENT}.myapp.com"

echo "Running health checks for $ENVIRONMENT..."

# API health
if ! curl -f "$BASE_URL/api/health" > /dev/null 2>&1; then
  echo "❌ API health check failed"
  exit 1
fi

# Database connection
if ! curl -f "$BASE_URL/api/health/db" > /dev/null 2>&1; then
  echo "❌ Database health check failed"
  exit 1
fi

# Key endpoints
ENDPOINTS=("/api/users" "/api/products" "/api/orders")
for endpoint in "${ENDPOINTS[@]}"; do
  if ! curl -f "$BASE_URL$endpoint" > /dev/null 2>&1; then
    echo "❌ Endpoint $endpoint health check failed"
    exit 1
  fi
done

echo "✅ All health checks passed"
exit 0
````

## Best Practices

1. **Fast rollback**: <5 minutes to previous version
2. **Automated**: One-click rollback workflow
3. **Verified**: Health checks after rollback
4. **Documented**: Clear runbook
5. **Tested**: Practice rollbacks regularly
6. **Monitored**: Alert on failures
7. **Communicated**: Notify stakeholders

## Output Checklist

- [ ] Manual rollback workflow
- [ ] Automated rollback on failure
- [ ] Platform-specific rollback (K8s/Docker)
- [ ] Database rollback procedure
- [ ] Rollback runbook documented
- [ ] Health check scripts
- [ ] Communication templates
- [ ] Incident issue automation

© patricio0312rev · MIT · patricio0312rev/skills

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

Все скиллы по теме «DevOps и инфраструктура» →
rollback-deploy BuildWithClaude Community Команда rollback-deploy ведёт откат релиза по шагам: оценка инцидента, проверки перед откатом, kubectl rollout undo, возврат трафика и сообщение пользователям. CX Codex +1 ★ 3 785звёзд репо deployment-engineer zhaono1 Скилл deployment-engineer настраивает пайплайны CI/CD, готовит конфигурации релизов и стратегии отката. Защищает прод: агент не запустит деплой без явного подтверждения. CX Codex +1 685установок devops-infrastructure CloudAI-X Скилл devops-infrastructure для Claude Code пишет Dockerfile, настраивает GitHub Actions, планирует развёртывания и организует мониторинг. Используется при контейнеризации, работе с пайплайнами, Terraform и production-инфраструктурой. CX Codex +1 ★ 1 424звёзд репо github-actions-workflow aj-geddes Скилл github-actions-workflow для сборки GitHub Actions: тесты, сборка, сканирование безопасности и деплой прямо из репозитория. CX Codex +1 629установок deploy-checklist официальный anthropics Скилл deploy-checklist собирает чек-лист перед релизом: проверки CI, ревью, миграций, флагов, выката и отката. Пригодится перед изменениями в продакшене. CX Codex +1 5 900установок SE: DevOps/CI официальный github Субагент SE: DevOps/CI для GitHub Copilot разбирает сбои релизов и собирает CI/CD-пайплайны, указывая, что изменить. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
tanstack-query-setup Скилл tanstack-query-setup ставит TanStack Query в React-проект: провайдер QueryClient, хуки на useQuery, мутации и правила кеша. Агент получает готовые шаблоны и подставляет в них ваш код. CX Codex +1 267установок hot-reload-optimizer Скилл hot-reload-optimizer для Claude Code оптимизирует hot module replacement и fast refresh в проектах на Vite, Next.js и webpack, ускоряя пересборки сервера разработки. CX Codex +1 267установок alerting-dashboard-builder Скилл alerting-dashboard-builder собирает SLO в YAML, правила алертов Prometheus на расход бюджета ошибок и шаблон дашборда с ключевыми панелями и ссылками на runbook. CX Codex +1 266установок contract-testing-builder Скилл contract-testing-builder внедряет контрактное тестирование API через Pact, OpenAPI и JSON Schema, чтобы изменения на бэкенде не ломали клиентские сервисы. CX Codex +1 266установок vector-db-setup Скилл vector-db-setup помогает развернуть векторные базы данных (Pinecone, Chroma, pgvector, Qdrant) и настроить семантический поиск с генерацией эмбеддингов OpenAI. CX Codex +1 266установок capacity-planning-helper Скилл capacity-planning-helper считает, сколько инстансов, базы и кеша нужно под прогноз трафика, и прикидывает месячный счёт по прайсу AWS. CX Codex +1 265установок data-seeding-fixtures-builder Скилл data-seeding-fixtures-builder генерирует детерминированные тестовые данные, фабрики сущностей и скрипты сброса базы данных для разработки и тестов. CX Codex +1 265установок docs-starter-kit Скилл docs-starter-kit генерирует комплект проектной документации: файлы README, CONTRIBUTING, SECURITY, лицензию и правила поведения для открытых и закрытых репозиториев. CX Codex +1 265установок

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

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