storekit · johnrogers — скилл для Claude Code: покупки в приложении на StoreKit 2
Скилл ведёт агента через реализацию покупок в приложении: конфиг .storekit, StoreManager, проверка транзакций и экраны на SwiftUI.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/storekit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/storekit/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill storekit -a codex2Вручную: положить файлы
.agents/skills/storekit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill storekit -a cursor2Вручную: положить файлы
.cursor/skills/storekit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/storekit2Вручную: положить файлы
.github/skills/storekit/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill storekit -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/storekitВручную: положить файлы
.devin/skills/storekit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.