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

storekit · johnrogers — скилл для Claude Code: покупки в приложении на StoreKit 2

Скилл ведёт агента через реализацию покупок в приложении: конфиг .storekit, StoreManager, проверка транзакций и экраны на SwiftUI.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает storekit

Внутри пять справочников: настройка .storekit, товары, подписки, транзакции и готовые StoreKit-вью. Скилл велит подгружать нужный файл, если задача хоть немного его касается, чтобы не пропустить готовый паттерн.

Порядок в работе задан жёстко. Сначала файл конфигурации .storekit, потом тестовые покупки в симуляторе Xcode, и только затем код. Логика собирается в один StoreManager под @MainActor, слушатель Transaction.updates ставится при запуске приложения, а не по нажатию кнопки. Товары показываются через ProductView или своё вью.

Самая дорогая ошибка — забыть transaction.finish() после выдачи доступа: транзакция не завершается, и покупка у пользователя не отображается. Общий StoreManager без @MainActor ловит гонки между асинхронными задачами, а захардкоженные идентификаторы товаров и цены мешают тестам и локализации.

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

  • Завести автопродлеваемую подписку на StoreKit 2 с нуля
  • Сделать .storekit конфиг и прогнать покупки в симуляторе до кода
  • Поймать возвраты и отмены через слушатель Transaction.updates
  • Закрыть гонки в StoreManager через @MainActor
  • Вынести идентификаторы товаров и цены из кода

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

  • Добавь автопродлеваемую подписку через StoreKit 2, начни с файла .storekit и тестовой покупки в симуляторе
  • Собери StoreManager под @MainActor и поставь слушатель Transaction.updates при запуске приложения
  • Проверь, что после выдачи доступа везде вызывается transaction.finish()

Как установить storekit

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill storekit -a claude-code

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

~/.claude/skills/storekit/SKILL.md

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

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

Вопросы о storekit

Как установить storekit в Claude Code?

Из маркетплейса: сначала /plugin marketplace add johnrogers/claude-swift-engineering, потом /plugin install swift-engineering@claude-swift-engineering.

Что делает скилл storekit?

Описывает сборку покупок в приложении на StoreKit 2: товары, подписки, проверку и завершение транзакций, экраны на SwiftUI. Агент подтягивает нужный из пяти справочников, когда задача доходит до соответствующей части.

Почему покупка не доходит до пользователя?

Скорее всего не вызван transaction.finish() после выдачи доступа. Без него транзакция остаётся незавершённой, и в приложении покупка не отражается.

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

SKILL.md · MIT
---
name: storekit
description: Use when implementing in-app purchases, StoreKit 2 subscriptions, consumables, non-consumables, or transaction handling. Covers testing-first workflow with .storekit configuration, StoreManager architecture, and transaction verification.
---

# StoreKit

StoreKit 2 patterns for implementing in-app purchases with async/await APIs, automatic verification, and SwiftUI integration.

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[Getting Started](references/getting-started.md)** | Setting up `.storekit` configuration file, testing-first workflow |
| **[Products](references/products.md)** | Loading products, product types, purchasing with `Product.purchase()` |
| **[Subscriptions](references/subscriptions.md)** | Auto-renewable subscriptions, subscription groups, offers, renewal tracking |
| **[Transactions](references/transactions.md)** | Transaction listener, verification, finishing transactions, restore purchases |
| **[StoreKit Views](references/storekit-views.md)** | ProductView, SubscriptionStoreView, SubscriptionOfferView in SwiftUI |

## Core Workflow

1. Create `.storekit` configuration file first (before any code)
2. Test purchases locally in Xcode simulator
3. Implement centralized `StoreManager` with `@MainActor`
4. Set up `Transaction.updates` listener at app launch
5. Display products with `ProductView` or custom UI
6. Always call `transaction.finish()` after granting entitlements

## Essential Architecture

```swift
@MainActor
final class StoreManager: ObservableObject {
    @Published private(set) var products: [Product] = []
    @Published private(set) var purchasedProductIDs: Set<String> = []
    private var transactionListener: Task<Void, Never>?

    init() {
        transactionListener = listenForTransactions()
        Task { await loadProducts() }
    }
}
```

## Common Mistakes

1. **Missing `.finish()` calls on transactions** — Forgetting to call `transaction.finish()` after granting entitlements causes transactions to never complete. The user won't see their purchase reflected. Always call `finish()`.

2. **Unsafe StoreManager state** — Shared `StoreManager` without `@MainActor` can have race conditions. Multiple async tasks can update `@Published` properties concurrently, corrupting state. Use `@MainActor` for thread safety.

3. **No transaction listener at app launch** — Not setting up `Transaction.updates` listener means app crashes or misses refunded/canceled purchases. Listen for transactions immediately in `@main`, not when user taps purchase button.

4. **Hardcoded product IDs** — Hardcoded IDs make testing and localization hard. Use configuration files or environment variables for product IDs. Same applies to prices (fetch from App Store, don't hardcode).

5. **Ignoring verification failures** — App Store verification fails silently sometimes. Not checking verification status means accepting unverified transactions (security risk). Always verify before granting entitlements.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

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

Все скиллы по теме «Мобильная разработка» →

Сначала — storekit от других авторов.

storekit dpearson2699 Помогает писать и проверять встроенные покупки и подписки на StoreKit 2: пейволлы, транзакции, проверка прав доступа. CX Codex +1 4 300установок storekit Prisma-Labs-Dev Кладёт агенту локальные Markdown-страницы по StoreKit 2: Product, Transaction, подписки, StoreView и SubscriptionStoreView. CX Codex +1 598установок generators rshankras Скилл generators генерирует готовый Swift-код для iOS и macOS: от аутентификации и пейволлов StoreKit 2 до логирования и SwiftData с iCloud. CX Codex +1 525установок revenuecat-migrate RevenueCat Скилл revenuecat-migrate помогает перенести покупки со StoreKit или Google Play Billing на RevenueCat и обновить SDK между мажорными версиями. Работает с iOS, Android, Flutter и другими платформами. CX Codex +1 832установок ShipSwift signerlabs MCP-сервер ShipSwift открывает доступ к каталогу готового кода для iOS и бэкенда. Пригодится при сборке интерфейсов SwiftUI, экранов оплаты и серверных функций. CX Codex +1 1 574установок app-store-review dpearson2699 Скилл app-store-review для Claude Code проверяет готовность iOS-приложения к отправке в App Store и ищет причины возможного отклонения. Запускается при подготовке релиза, ответе на отклонение или сверке данных о приватности. CX Codex +1 4 900установок app-store-optimization dpearson2699 Скилл app-store-optimization помогает составить метаданные для страницы приложения в App Store. Он распределяет ключевые слова между названием, подзаголовком и полем keywords для лучшей видимости и конверсии. CX Codex +1 3 200установок axiom-integration CharlesWiltgen Скилл axiom-integration для Claude Code направляет ИИ-кодинг по интеграциям iOS с системными функциями Apple. Срабатывает для Siri, виджетов, покупок и фоновых задач. CX Codex +1 1 400установок

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

Весь набор →
swift-diagnostics Скилл swift-diagnostics помогает разбирать сбои навигации, сборки и памяти в проектах iOS и macOS. Он ведёт по диагностическим шагам до проверки исправления. CX Codex +1 ★ 233звёзд репо localization Скилл localization ведёт агента по локализации iOS-приложения: String Catalogs, формы множественного числа, форматы дат и вёрстка справа налево. CX Codex +1 ★ 233звёзд репо swiftui-advanced Скилл swiftui-advanced для Claude Code с правилами по сложным жестам, адаптивной вёрстке, выбору архитектуры и профилированию в SwiftUI. CX Codex +1 ★ 233звёзд репо haptics Помогает добавить тактильную отдачу для подтверждений, ошибок и действий пользователя в iOS-приложении. Работает с UIKit и Core Haptics. CX Codex +1 ★ 233звёзд репо swift-code-reviewer Субагент swift-code-reviewer проверяет код на Swift и iOS на безопасность, строгую конкурентность, производительность и соответствие HIG перед тестированием. CX Codex ★ 233звёзд репо ios-26-platform Скилл ios-26-platform помогает внедрять возможности iOS 26 в SwiftUI и сохранять поддержку iOS 17/18. Пригодится при обновлении интерфейса или настройке совместимости. CX Codex +1 ★ 233звёзд репо swiftui-specialist Субагент swiftui-specialist пишет SwiftUI-экраны по Apple HIG после того, как бизнес-логика и TCA уже готовы. CX Codex ★ 233звёзд репо swift-ui-design Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI. CX Codex ★ 233звёзд репо

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

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