storekit

该 Skill 按问题类型把 StoreKit 2 内购实现任务路由到 knowledge/storekit/ 下的知识合约，覆盖产品加载与购买、交易校验与权益、交易更新与恢复购买、订阅状态与续订信息四类。仅限 StoreKit 2 async/await API，遗留 StoreKit 1、服务端收据校验与 App Store Server API、测试配置均不在范围内。

caglarbaranbora

热度 0.00

最近更新 2026-10-18 16:48:09

分类：知识依赖：读写文件应用场景：API 集成 / 概念解释

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add caglarbaranbora/apple-agent-kit/storekit

Metadata

name: storekit
description: Route StoreKit 2 in-app purchase implementation tasks to the correct Knowledge Contracts -- product loading, purchase initiation, transaction verification, entitlements, transaction updates, restoring purchases, and subscription status/renewal info. Use when calling Product.products(for:), product.purchase(), handling Product.PurchaseResult, checking VerificationResult, reading Transaction.currentEntitlements, calling transaction.finish(), listening to Transaction.updates, calling AppStore.sync(), or reading Product.SubscriptionInfo.Status/RenewalInfo/renewalState. v1 is StoreKit 2 async/await API only -- no legacy StoreKit 1 (SKPaymentQueue/SKProduct/SKPaymentTransaction), no server-side receipt validation or App Store Server API, no StoreKit Configuration file test setup. Triggers on StoreKit, Product.products, product.purchase, PurchaseResult, VerificationResult, currentEntitlements, transaction.finish, Transaction.updates, AppStore.sync, restore purchases, SubscriptionInfo.Status, RenewalInfo, renewalState, subscription group, in-app purchase, IAP.
id: skill.storekit.foundations
title: StoreKit — Foundations
version: 1.0.0
status: Approved
artifact_type: skill
domain: StoreKit
routes: ["knowledge.storekit.product-loading-and-purchase","knowledge.storekit.transaction-verification-and-entitlements","knowledge.storekit.transaction-updates-and-restoring-purchases","knowledge.storekit.subscription-status-and-renewal-info"]
related: []
last_updated: "2026-08-08T00:00:00.000Z"

StoreKit — Foundations Skill

Purpose

Route StoreKit 2 in-app purchase implementation tasks to the minimum required StoreKit Knowledge Contracts. v1 scope is the modern StoreKit 2 async/await API surface only — no legacy StoreKit 1, no server-side receipt validation or App Store Server API, no StoreKit Configuration file test setup in Xcode.

Routing

Load only the contracts relevant to the task. All paths relative to knowledge/storekit/.

Loading products with Product.products(for:), initiating a purchase with product.purchase(), or handling Product.PurchaseResult (.success/.userCancelled/.pending) -> product-loading-and-purchase.md
Checking a VerificationResult for .verified/.unverified, reading Transaction.currentEntitlements, or calling transaction.finish() -> transaction-verification-and-entitlements.md
The Transaction.updates listener task or calling AppStore.sync() to restore purchases -> transaction-updates-and-restoring-purchases.md
Reading Product.SubscriptionInfo.Status/RenewalInfo/renewalState, or same-subscription-group upgrade/downgrade behavior -> subscription-status-and-renewal-info.md

Never load more than the contracts relevant to the specific question.

Stop Conditions

Stop and report if the requested topic has no matching Knowledge Contract in knowledge/storekit/ — do not guess or fall back to general knowledge.

Legacy StoreKit 1 (SKPaymentQueue, SKProduct, SKPaymentTransaction) — Deferred
Server-side receipt validation and the App Store Server API — Deferred
StoreKit Configuration file test setup — Deferred
The App Review compliance angle — the requirement to use IAP to unlock content, prohibited alternative unlock mechanisms, loot-box odds disclosure, the restore-mechanism requirement, and the non-expiration rule for purchased currencies — owned by app-store-review-guidelines