claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

🔐revenuecat-entitlements-gate

プラグイン
rc
ソース
GitHub で見る ↗

説明

RevenueCatユーザーが、エンタイトルメントを通じて有料機能へのアクセス権を現在持っているかどうかを確認します。 次のような場合に使用: - 機能をプレミアム会員限定にしたい - ユーザーがProサブスクリプションを持っているか確認したい - `customerInfo` のアクティブなエンタイトルメントを読み取りたい - サブスクリプションの状態に応じて機能の表示・非表示を切り替えたい - エンタイトルメントの変更に対応したい - iOS、Android、Kotlin Multiplatform、Flutter、またはReact Nativeで「ユーザーはサブスクライブ済みか」を確認したい

原文を表示

Check whether a RevenueCat user currently has access to a paid feature via entitlements. Use when the user asks to gate a feature behind premium, check if the user has a pro subscription, read customerInfo active entitlements, show or hide a feature based on subscription status, react to entitlement changes, or 'is the user subscribed' on iOS, Android, Kotlin Multiplatform, Flutter, or React Native.

ユースケース

  • ✓機能をプレミアム会員限定にしたい
  • ✓ユーザーがProサブスクリプションを持っているか確認したい
  • ✓サブスクリプション状態に応じて機能の表示・非表示を切り替えたい
  • ✓ユーザーがサブスクライブ済みか確認するとき

本文（日本語訳）

revenuecat-entitlements-gate: RevenueCat エンタイトルメントの確認

次のような場合に使用: ユーザーが RevenueCat のアクティブなエンタイトルメントに基づいて、機能の表示・非表示を制御したい場合。 このスキルは、ワンショットチェックとリアクティブリスナーをカバーします。 購入処理（revenuecat-purchase-flow を参照）や認証（revenuecat-identify-user を参照）はスコープ外です。

1. プラットフォームの検出

作業ディレクトリを確認し、上から順に最初に一致したものを選択します:

  1. React Native: package.json に react-native-purchases のエントリがある、または react-native が依存関係に含まれる → platforms/react-native.md を読む。expo も依存関係に含まれる場合は、Expo プロジェクトとして記録する。
  2. Flutter: プロジェクトルートに pubspec.yaml が存在する → platforms/flutter.md を読む。
  3. Kotlin Multiplatform: build.gradle.kts に kotlin { … } のマルチプラットフォームソースセットブロックが含まれる、または com.revenuecat.purchases:purchases-kmp* に依存している → platforms/kmp.md を読む。
  4. Android（ネイティブ）: build.gradle(.kts) が com.android.application を適用している（かつ KMP でない）→ platforms/android.md を読む。
  5. iOS（ネイティブ）: プロジェクトルートに Package.swift、*.xcodeproj、*.xcworkspace、または Podfile が存在する → platforms/ios.md を読む。

複数が一致する場合（例: Flutter プロジェクト内に ios/ フォルダがある場合）は、ビルドを管理している最も外側のプロジェクトを選択します。 それでも判断が難しい場合は、どのプラットフォームを設定するかユーザーに確認してください。

2. 共通の概念（全プラットフォーム共通）

  • プロダクト ID ではなく、エンタイトルメント識別子を確認すること。 識別子（例: "premium"）は RevenueCat ダッシュボードで設定され、1 つ以上のプロダクトにマッピングされます。 エンタイトルメントを使用することで、アプリのコードに触れることなく、プロダクト・価格・ストアを変更できます。

  • customerInfo.entitlements.active が信頼できる情報源です。 これはエンタイトルメント識別子をキーとする Map<String, EntitlementInfo> です。 active に存在すれば現在アクセス権があり、存在しなければ過去の購入履歴に関わらずアクセス権はありません。

  • 購入履歴を元にゲートを設けないこと。 有効期限切れのサブスクリプションは customerInfo.entitlements.all には残りますが、active からは除外されます。 必ず active のみを使用してください。

  • 最初に一度取得し、その後はサブスクライブすること。 初回の customerInfo 呼び出しはキャッシュされた値を素早く返し、SDK がバックグラウンドで更新します。 すべての SDK は、エンタイトルメントの変更（購入・復元・更新・期限切れの後）が発生したときに発火するリスナーまたはストリームを提供しています。 ポーリングではなく、これをサブスクライブしてください。

  • SDK を先に設定しておく必要があります。 Purchases.configure(…) が実行されていない場合、エンタイトルメントの呼び出しは失敗します。 このスキルを使用する前に、integrate-revenuecat を使って SDK をセットアップしてください。

3. 実装

検出結果に対応するプラットフォームファイルを読んでください:

  • platforms/ios.md
  • platforms/android.md
  • platforms/kmp.md
  • platforms/flutter.md
  • platforms/react-native.md

各プラットフォームファイルには、ワンショットチェック・リアクティブサブスクリプション・それぞれの典型的な配置場所が示されています。

4. 検証

以下をすべて確認するまで、ゲートが機能していると宣言しないこと:

  1. アクティブなエンタイトルメントを持つユーザーにはゲート対象の機能が表示され、持たないユーザーには表示されない。
  2. エンタイトルメントの状態が変化したとき（サンドボックス購入またはダッシュボードからの手動付与でテスト）、手動再起動なしに UI が更新される（リスナーが正しく接続されていることの確認）。
  3. コード内のエンタイトルメント識別子が、RevenueCat ダッシュボードに存在する識別子と一致している。 タイポがあると、すべてのユーザーに対して無音でアクセスが遮断されます。
原文（English）を表示

revenuecat-entitlements-gate: check a RevenueCat entitlement

Use this skill when the user wants to decide whether to show or hide a feature based on an active RevenueCat entitlement. The skill covers the one shot check and the reactive listener; it does not cover purchasing (see revenuecat-purchase-flow) or auth (revenuecat-identify-user).

1. Detect the platform

Inspect the working directory and pick the first match, from top to bottom:

  1. React Native: package.json has a react-native-purchases entry, or react-native as a dependency → read platforms/react-native.md. If expo is also a dependency, note it as an Expo project.
  2. Flutter: pubspec.yaml exists at the project root → read platforms/flutter.md.
  3. Kotlin Multiplatform: build.gradle.kts contains a kotlin { … } multiplatform source sets block, or depends on com.revenuecat.purchases:purchases-kmp* → read platforms/kmp.md.
  4. Android (native): build.gradle(.kts) applies com.android.application (and is not KMP) → read platforms/android.md.
  5. iOS (native): Package.swift, *.xcodeproj, *.xcworkspace, or Podfile at the project root → read platforms/ios.md.

If several match (e.g. an ios/ folder inside a Flutter project), pick the outermost project, the one that owns the build. If still ambiguous, ask the user which platform they want to configure.

2. Shared concepts (all platforms)

  • Check the entitlement identifier, not the product ID. The identifier (for example "premium") is configured in the RevenueCat dashboard and mapped to one or more products. Using the entitlement lets you change products, prices, and stores without touching app code.
  • customerInfo.entitlements.active is the source of truth. It is a Map<String, EntitlementInfo> keyed by entitlement identifier. Presence in active means the user currently has access. Absence means they do not, regardless of past purchases.
  • Do not gate on purchase history. Expired subscriptions still appear in customerInfo.entitlements.all but drop out of active. Use active only.
  • Fetch once, then subscribe. The first customerInfo call returns a cached value quickly, and the SDK refreshes in the background. Every SDK exposes a listener or stream that fires when entitlements change (after a purchase, restore, renewal, or expiration). Subscribe to that instead of polling.
  • The SDK must be configured first. If Purchases.configure(…) has not run, the entitlement call will fail. Set up the SDK via integrate-revenuecat before using this skill.

3. Implementation

Read the platform file that matches detection:

  • platforms/ios.md
  • platforms/android.md
  • platforms/kmp.md
  • platforms/flutter.md
  • platforms/react-native.md

Each platform file shows the one shot check, the reactive subscription, and where to place each in a typical app.

4. Verify

Do not claim the gate works until:

  1. A user with an active entitlement sees the gated feature, and a user without it does not.
  2. When the entitlement state changes (test with a sandbox purchase or a manual grant in the dashboard), the UI updates without a manual restart, confirming the listener is wired.
  3. The entitlement identifier in the code matches an identifier that exists in the RevenueCat dashboard. A typo here silently gates everyone out.

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。