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

capgo-release-workflows — скилл для Claude Code: релиз-пайплайн

Скилл capgo-release-workflows собирает релиз-пайплайн для Capacitor-приложений: OTA-обновления Capgo, нативные сборки и публикацию в App Store / Play с автоматическим выбором пути — bundle releaseType решает, нужна ли сборка.

MIT 769 установок ★ 79 обновлён 2026-10-17

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

Что делает capgo-release-workflows

Скилл строит единый релизный процесс в CI репозитория: веб-правки идут через Capgo OTA, изменения нативных пакетов запускают сборку (Capgo Build или свои раннеры), результат публикуется в сторы. В основе — автоматический гейт на git-проверке путей (ios/, android/) и команде bundle releaseType, которая читает метаданные нативных пакетов из канала и возвращает OTA или native. Без FFmpeg и без дополнительных зависимостей.

Скилл создаёт ветвление CI: OTA-ветка выполняет bundle upload --channel staging --fail-on-incompatible, затем channel promote staging production с возможностью --rollout 10; нативная ветка запускает build request или Xcode/Gradle, после чего загружает бандл с --auto-min-update-version, чтобы канал продвинул базовую версию. Каналы настраиваются с метаданной стратегией (channel set production --disable-auto-update metadata), чтобы каждая загрузка фиксировала нативную базу. Скилл готовит план отката: для OTA — channel set --bundle <previous>, для нативных релизов откат невозможен, и веб-слой должен уметь патчить.

Требуется @capgo/capacitor-updater с мажорной версией, совпадающей с @capacitor/core, и вызов notifyAppReady() в коде приложения. В CI нужны секреты CAPGO_TOKEN (с правом загрузки) и опционально CAPGO_PRIVATE_KEY для шифрованных бандлов; подписи для нативных платформ либо из Capgo (build credentials manage), либо из существующего хранилища CI.

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

  • заменить Appflow собственным CI, контролируя OTA и сборки
  • научить CI различать веб-правки и нативные изменения
  • организовать staged-каналы (development, staging, production) с откатом
  • связать Capgo OTA, Capgo Build и публикацию в сторы одним процессом
  • выгрузить нативные креденшелы из Capgo в GitHub/GitLab secrets

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

  • Построй релиз-пайплайн для Capacitor-приложения: OTA через Capgo, нативные сборки через Capgo Build, публикация в сторы, автоматический выбор пути
  • Настрой каналы development, staging, production с метаданной стратегией для com.example.app
  • Добавь в GitHub Actions гейт, который проверяет изменения в ios/, android/ и вызывает bundle releaseType

Как установить capgo-release-workflows

1Через Skills CLI (Vercel)

npx skills add Cap-go/capgo-skills --skill capgo-release-workflows -a claude-code

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

~/.claude/skills/capgo-release-workflows/SKILL.md

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

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

Вопросы о capgo-release-workflows

Как установить capgo-release-workflows в Claude Code?

Выполни npx skills add Cap-go/capgo-skills --skill capgo-release-workflows -a claude-code. Файл появится в ~/.claude/skills/capgo-release-workflows/SKILL.md.

Что делает capgo-release-workflows?

Скилл собирает релиз-пайплайн для Capacitor-приложений, который объединяет Capgo OTA, нативные сборки и публикацию в сторы. CI автоматически выбирает путь: веб-правки идут через OTA, нативные изменения запускают сборку.

Какие секреты нужны для работы capgo-release-workflows?

В CI требуются CAPGO_TOKEN (с правом загрузки) и CAPGO_PRIVATE_KEY, если бандлы шифруются. Нативные подписи экспортируются из Capgo командой build credentials manage или остаются в существующем хранилище секретов CI.

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

SKILL.md · MIT
---
name: capgo-release-workflows
description: Designs repository-owned release pipelines for Capacitor apps that combine Capgo live updates, native builds (Capgo Build or the team's own CI runners), and App Store / Play publishing, with an automatic OTA-vs-native gate (`bundle releaseType`, `build needed`), staged channels, and rollback. Use when the user wants one release system covering OTA, builds, and store publishing, is replacing a hosted release service with CI they own, or asks how CI should decide between a live update and a store build. Do not use for single-step tasks (capgo-release-management, capgo-native-builds, capgo-live-updates), non-Capacitor apps, or Ionic Enterprise plugin migration (ionic-enterprise-sdk-migration).
---

# Capgo Release Workflows

Set up an end-to-end release system: Capgo OTA for web changes, native builds for binary changes, store publishing, and a CI gate that picks the right path.

## When to Use

TRIGGER when:

- The user wants a single release pipeline covering live updates, native builds, and store publishing.
- The user is moving off a hosted release service (Appflow-style) to CI they own.
- The user asks "how does CI know if this needs a store release?"

Do not use when:

- The user needs one operation (upload or promote a bundle, request one build). Use `capgo-release-management` or `capgo-native-builds`.
- The user is wiring the updater plugin. Use `capgo-live-updates`.
- The user is migrating off Ionic Appflow specifically. Start with `ionic-appflow-migration`, then return here for the pipeline.
- The app is not Capacitor.

## Building Blocks

| Area | Skill | Key command |
| --- | --- | --- |
| OTA updates | `capgo-live-updates`, `capgo-release-management` | `bundle upload`, `channel promote` |
| Native builds on Capgo | `capgo-native-builds` | `build request` |
| Native builds on own runners | `capacitor-ci-cd` | Xcode / Gradle / Fastlane |
| Store listing and review | `capacitor-app-store`, `capacitor-apple-review-preflight` | n/a |

## Procedure

### 1. Inventory (inspect, then report)

Find out:

- Which CI system runs (`.github/workflows`, `.gitlab-ci.yml`, `bitbucket-pipelines.yml`, `azure-pipelines.yml`).
- Whether `@capgo/capacitor-updater` is installed with the major that matches `@capacitor/core`, and whether `notifyAppReady()` is called.
- The existing Capgo channels (`npx @capgo/cli@latest channel list <appId>`) and the default channel.
- Where native signing lives (Capgo credentials, CI secrets, Fastlane match).
- Whether store uploads are required, or only internal distribution.

Report the gaps to the user and ask before you choose Capgo Build or their own runners for native builds.

### 2. Define channels and versioning

- Typical channels: `development` (self-assign), `staging`, `production` (default).
- Use semver bundle versions. In CI, use `--bundle <ver>` or `--auto-bump patch`, plus `--version-exists-ok`.
- Set production to the metadata strategy once, so every upload records its native baseline:

```bash
npx @capgo/cli@latest channel set production com.example.app --disable-auto-update metadata
```

### 3. Add the OTA-vs-native gate

```bash
# After npm ci && npm run build
if git diff --name-only "$BASE" HEAD | grep -qE '^(ios/|android/|capacitor\.config\.)'; then
  TYPE=native
else
  TYPE=$(npx @capgo/cli@latest bundle releaseType com.example.app --channel production | tr -d '[:space:]')
fi
```

`releaseType` prints `OTA` or `native` from native package metadata. It cannot see raw native edits, which is why the git-path check is there. `build needed` is the exit-code version: exit 1 means native is required, exit 0 means OTA is fine, exit 2 means the command failed.

### 4. Wire both branches

- **OTA:** `bundle upload --channel staging --fail-on-incompatible --auto-min-update-version`, then a manual or approved `channel promote staging production`, optionally with `--rollout 10`.
- **Native:** run `build request --platform ios|android` (Capgo Build) or the native jobs, then upload the matching bundle with `--auto-min-update-version` so the channel baseline advances. Do **not** pass `--fail-on-incompatible` on that baseline upload, because the native packages are supposed to differ.

Full GitHub Actions and GitLab templates: https://capgo.app/docs/builder/ci-ota-or-native/

### 5. Rollback plan (write it down before the first release)

- OTA: `channel set production --bundle <previous>` or `--rollout-rollback`. Auto-pause with `--auto-pause-enabled --auto-pause-action rollback`.
- Native: there is no rollback in the stores. Ship a fixed build, and keep OTA able to patch the web layer.

### 6. Secrets

- `CAPGO_TOKEN` (upload-capable, least privilege) and `CAPGO_PRIVATE_KEY` if bundles are encrypted.
- Native signing: export from Capgo with `build credentials manage` → `.env`, then `gh secret set -f`. Or keep the existing CI secret store.
- Never commit `.capgo`, `.capgo_key_v2`, `.capgo-credentials.json`, or `.env.capgo.*`.

## Verification

Run once, end to end:

1. A web-only commit takes the OTA branch. A device on staging gets the bundle (`npx @capgo/cli@latest app debug <appId>`).
2. A commit that adds or upgrades a native plugin takes the native branch. The build succeeds and lands in TestFlight or the Play internal track.
3. After the native release, `bundle releaseType --channel production` returns `OTA` again for web-only changes.
4. A practice rollback (`channel set --bundle <previous>`) reaches a test device.

## Error Handling

- CI uploads fail with `No Capgo API key found`: `CAPGO_TOKEN` is not exported to the step's `env`.
- `Bundle NOT compatible with production channel` in the OTA branch: the gate was skipped or `releaseType` ran against a different channel.
- Signing failures: fix credentials first (`capgo-native-builds`, `build prescan`) before you touch pipeline logic.
- Store failures: split the iOS and Android jobs so one platform does not block diagnosis of the other.

## Resources

- OTA or native in CI: https://capgo.app/docs/builder/ci-ota-or-native/
- CI/CD integration: https://capgo.app/docs/getting-started/cicd-integration/
- Capgo Build GitHub Actions: https://capgo.app/docs/builder/github-actions/
- Native + OTA channel workflow: https://capgo.app/docs/live-updates/native-ota-channel-workflow/

© Cap-go · MIT · Cap-go/capgo-skills

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

Все скиллы по теме «Мобильная разработка» →
capgo-cloud-migration capawesome-team Скилл capgo-cloud-migration ведёт агента через перенос Capacitor-проекта с Capgo на Capawesome Cloud: находит следы Capgo и меняет плагин, конфиг, каналы и CI/CD. CX Codex +1 972установок capawesome-cloud capawesome-team Скилл проводит агента через настройку Capawesome Cloud: облачные сборки iOS и Android, OTA-обновления и автопубликация в App Store и Google Play. CX Codex +1 1 400установок eas-app-stores expo Скилл eas-app-stores для Claude Code настраивает сборку и отправку приложений iOS и Android через EAS. Он включается для подготовки релиза в TestFlight, App Store или Google Play. CX Codex +1 28 700установок otakit OtaKit MCP-сервер для Claude Code и других клиентов. Подключает агента к OtaKit: посмотреть проект, загрузить сборку, выпустить обновление и откатить его для Capacitor-приложений. CX Codex +1 ★ 53звёзд репо asc-release-flow rorkai Скилл asc-release-flow ведёт релиз iOS-приложения от подготовленного плана до отправки на ревью в App Store. Полезен, когда версия уже собрана и её надо застейджить, залить или опубликовать. CX Codex +1 8 700установок release-review rshankras Скилл release-review прогоняет приложение для macOS и iOS по чек-листам релиза и выдаёт список проблем с готовыми правками. Пригодится перед отправкой в App Store или TestFlight. CX Codex +1 550установок

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

Весь набор →
capgo-cli-usage Скилл capgo-cli-usage связывает агента с утилитой Capgo CLI, настраивает ключи доступа и перенаправляет запросы в специализированные скиллы. CX Codex +1 793установок capacitor-plugin-upgrades Скилл capacitor-plugin-upgrades для Claude Code ведёт обновление библиотеки Capacitor-плагина между мажорными версиями. Он подключается, когда нужно поднять peerDependencies или добавить поддержку новой версии Capacitor. CX Codex +1 791установок capacitor-plugin-spm-support Скилл capacitor-plugin-spm-support переводит iOS-часть плагина Capacitor на Swift Package Manager с сохранением podspec. Помогает убрать ошибку «plugin is not implemented on ios» в проектах с SPM. CX Codex +1 776установок capgo-native-builds Скилл capgo-native-builds настраивает сборку нативных пакетов iOS и Android в Capgo Cloud Build, генерацию сертификатов и прямую отправку в TestFlight или Google Play. CX Codex +1 774установок capgo-release-management Скилл capgo-release-management для Claude Code ведёт релизы Capgo из CLI: загрузка бандлов, каналы, постепенный выкат, откат и шифрование. Закрывает сломанный релиз или откат бандла. CX Codex +1 768установок sqlite-to-fast-sql Скилл sqlite-to-fast-sql для Claude Code переводит хранилище Capacitor на @capgo/capacitor-fast-sql. Заменяет вызовы базы данных, настраивает локальный транспорт и правит сетевые манифесты платформ. CX Codex +1 768установок capacitor-app-upgrade-v7-to-v8 Скилл capacitor-app-upgrade-v7-to-v8 для Claude Code переводит приложение Capacitor с версии 7 на версию 8. Запускается по запросу обновить проект с @capacitor/core версии 7.x до 8.x. CX Codex +1 762установок webapp-to-capacitor Скилл webapp-to-capacitor для Claude Code переводит веб-приложения, PWA и SPA в мобильные сборки Capacitor под iOS и Android. Он помогает обойти реджект по правилу Apple 4.2 и адаптировать проект под мобильный UX. CX Codex +1 756установок

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

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