asc-revenuecat-catalog-sync

asc-revenuecat-catalog-sync スキルの概要

asc-revenuecat-catalog-sync は、App Store Connect と RevenueCat の内容を揃えるためのワークフロースキルです。差分の監査、ASC 側で不足しているサブスクリプションやアプリ内課金の作成、そしてそれらを RevenueCat の products、entitlements、offerings、packages に対応付ける作業を、手作業で何度も照合することなく進められるようにします。

この asc-revenuecat-catalog-sync skill は、すでにどちらか一方にカタログがあり、もう一方へ確実に写し取りたい ecommerce チームやサブスクリプションチームに向いています。主な目的は「RevenueCat を学ぶ」「ASC を学ぶ」ことではありません。散らばって部分的にしか一致していないカタログ情報を、変更を書き込む前にレビューできる決定的な同期プランに落とし込むことです。

このスキルが得意なこと

• 既存の ASC カタログを起点に RevenueCat を立ち上げる
• RevenueCat にマッピングする前に、ASC 側で不足しているサブスクリプションや IAP を作成する
• リリース前や移行前に差分監査を実施する
• 本番中の製品を壊さないよう、安定した識別子を維持する

何が違うのか

• 推測ではなく識別子ベースで動く: ASC productId をシステム間の主キーとして扱う
• 一発のプロンプトより安全: 監査を先に行う前提のワークフローになっている
• 同期ミスや手作業の突き合わせを減らすために、asc-revenuecat-catalog-sync ガイドを実務で使いたいチームに実用的

どんなときに適しているか

すでに ASC と RevenueCat MCP の認証が済んでいて、繰り返し使える同期プロセスがほしいなら asc-revenuecat-catalog-sync を使う価値があります。高レベルのプロダクト戦略だけが必要な場合や、一度きりの命名ブレストだけしたい場合は、このスキルは少し大げさかもしれません。

asc-revenuecat-catalog-sync スキルの使い方

まずインストールして、正しいファイルを読む

asc-revenuecat-catalog-sync のインストールは次のコマンドで行います。

npx skills add rudrankriyam/app-store-connect-cli-skills --skill asc-revenuecat-catalog-sync

その後は skills/asc-revenuecat-catalog-sync/SKILL.md から読み始めてください。このリポジトリには補助フォルダを探し回る必要がないため、スキルファイル自体が唯一の正です。最初の読み込みが特に重要になるので、実行前に前提条件、安全側のデフォルト、そして標準の識別子ルールに集中して確認してください。

スキルが使える入力を具体的に渡す

asc-revenuecat-catalog-sync usage は、曖昧な目的よりも具体的なカタログ情報があると最もよく機能します。次の情報を含めてください。

• ASC app ID
• RevenueCat project_id
• 対象アプリ種別: app_store または mac_app_store
• 作成フローで使う bundle ID
• 監査のみか write mode か
• ASC productId と RevenueCat store_identifier の既知の対応ペア

よいプロンプトの例は次のとおりです。

「app 123456789 の ASC カタログを RevenueCat と突き合わせて監査してください。まずは audit mode でお願いします。現在の ASC product ID 一覧と、既存の RevenueCat store identifier 一覧は以下です。write を提案する前に、不足項目、食い違い、安定していない識別子を指摘してください。」

いちばん安全な作業順に従う

良い asc-revenuecat-catalog-sync guide は、通常次の順番で進めます。

1. asc と RevenueCat MCP の認証を確認する
2. まず read-only の audit mode を実行する
3. 不足項目、ドリフト、識別子の不一致を確認する
4. 提案された create や update を明示的に承認する
5. 差分を理解してから write を適用する

asc-revenuecat-catalog-sync for Ecommerce では、識別子を真実の源として扱い、本番化後に場当たり的なリネームを避けることが、品質向上の最大要因です。

スキル本文のリポジトリ規則を確認する

実行前に、SKILL.md で次の 3 点を必ず確認してください。

• 安全側のデフォルト: delete しない、write 前に明示的な確認が必要
• 障害時の扱い: アイテムごとに継続し、失敗を要約する
• 標準マッピング: productId は store_identifier と一致させる

これらのルールがあるからこそ、このスキルはデモ用の便利機能ではなく、本番運用に耐えるものになります。

asc-revenuecat-catalog-sync スキル FAQ

これは RevenueCat ユーザー専用ですか？

いいえ。App Store Connect と RevenueCat の両方を使っていて、両者の間にきれいな対応レイヤーが必要なチーム向けです。RevenueCat MCP を使っていないなら、このスキルの有用性はかなり下がります。

カタログがぐちゃぐちゃでも使えますか？

はい。ただし、最初は audit mode と手動レビューから始める前提で考えてください。このスキルは、ドリフトや不足項目をあぶり出すためのもので、曖昧な対応関係をすべて自動で推測するためのものではありません。

一般的なプロンプトより優れていますか？

多くの場合はそうです。一般的なプロンプトでも目的は説明できますが、asc-revenuecat-catalog-sync skill には、認証、安定した識別子、監査先行、安全な no-delete 動作といった重要な運用制約が組み込まれています。その分、誤ってカタログがずれるリスクを下げられます。

導入を一番妨げるものは何ですか？

認証不足、app ID や project ID の不足、そして識別子戦略が曖昧なことです。ASC productId と RevenueCat store_identifier の対応を確認できないと、同期は推測頼みになり、出力の品質はすぐに落ちます。

asc-revenuecat-catalog-sync スキルを改善するには

正確なソース・オブ・トゥルースを渡す

もっとも効果的な改善は、入力をきれいにすることです。現在の ASC カタログ、現在の RevenueCat カタログ、そして既知のマッピング表を、構造化された一覧で送ってください。asc-revenuecat-catalog-sync skill は、「monthly plan」や「premium offering」といった文章を読むより、正確な識別子を比較できるときのほうが、はるかにうまく動きます。

変更したい範囲を明示する

スキルに次のどれを求めているのかを伝えてください。

• audit only
• 不足している ASC 項目の作成
• 既存項目の RevenueCat へのマッピング
• リリース向けの全面的な突き合わせ

この範囲指定によって、モデルが最適化すべき対象が変わります。指定がないと、本当は差分レポートだけ欲しかったのに、write 用の計画を過剰に作り込んでしまうことがあります。

不一致を命名の問題ではなく、ワークフローの問題として扱う

結果が変に見えるとき、原因は不安定な ID、認証不足、またはソースデータの欠落であることが多いです。まずそこを直してから再実行してください。asc-revenuecat-catalog-sync usage で最も価値のある反復は、識別子を締め直して audit mode を再実行することであって、より広い発想ブレストを求めることではありません。

差分を出してから検証する

2 回目の実行では、次の項目を簡潔に列挙してもらうのが有効です。

• 不足している ASC 項目
• ASC に一致しない RevenueCat 項目
• 識別子の衝突
• 提案される create/update アクション

この形式だと、変更のレビューと承認がしやすくなります。特に ecommerce のサブスクリプションカタログでは、小さな不一致でも課金や entitlement の問題につながることがあるため、確認のしやすさが重要です。