asc-revenuecat-catalog-sync

asc-revenuecat-catalog-sync 技能概覽

asc-revenuecat-catalog-sync 是一個用來讓 App Store Connect 與 RevenueCat 保持一致的工作流程技能。它能幫你檢查資料漂移、建立缺少的 ASC 訂閱或 App 內購買項目，並把這些項目對應到 RevenueCat 的 products、entitlements、offerings 和 packages，減少大量手動交叉比對。

這個 asc-revenuecat-catalog-sync skill 特別適合已經在某個系統中有商品目錄，且需要一個可靠方式把它同步到另一個系統的電商與訂閱團隊。它要解決的核心工作，不是單純「學 RevenueCat」或「學 ASC」，而是把雜亂、部分對上的 catalog 資料，轉成一份你可以在寫入前審核的確定性同步方案。

這個 asc-revenuecat-catalog-sync 技能適合什麼情境

• 以既有 ASC catalog 為基礎，快速建立 RevenueCat。
• 先建立缺少的 ASC subscriptions 或 IAP，再對應到 RevenueCat。
• 在上線或遷移前執行 drift 稽核。
• 保留穩定識別碼，避免正式上線中的產品被破壞。

asc-revenuecat-catalog-sync 的差異在哪裡

• 它以識別碼為核心，不靠猜測：ASC productId 是跨系統的主要鍵值。
• 它比一次性的提示更安全，因為它預設採取先稽核、後寫入的工作流程。
• 對使用 asc-revenuecat-catalog-sync 指南來降低同步錯誤與人工對帳成本的團隊來說，它很實用。

什麼情況下適合使用 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 開始。在這個 repository 裡沒有其他輔助資料夾可先翻，因此 skill 檔本身就是唯一的事實來源。也正因如此，第一次閱讀特別重要：在嘗試執行任何操作前，先看清楚前置條件、安全預設，以及標準識別碼規則。

輸入要給得夠具體，skill 才能真正派上用場

asc-revenuecat-catalog-sync usage 最適合的輸入，不是模糊目標，而是具體的 catalog 事實。請提供：

• ASC app ID
• RevenueCat project_id
• 目標 app 類型：app_store 或 mac_app_store
• 建立流程所需的 bundle ID
• 你要的是 audit-only 還是 write mode
• 任何已知的對應關係，介於 ASC productId 與 RevenueCat store_identifier 之間

一個好的提示像這樣：

「幫我檢查 app 123456789 的 ASC catalog 與 RevenueCat 是否一致。先使用 audit mode。這是目前的 ASC product IDs 清單，以及現有的 RevenueCat store identifiers。請先標出缺少的項目、不一致之處，以及任何不穩定的識別碼，再提出寫入建議。」

依照最安全的工作流程順序來做

一個好的 asc-revenuecat-catalog-sync guide 通常會照這個順序：

1. 確認 asc 和 RevenueCat MCP 的驗證已完成。
2. 先跑唯讀的 audit mode。
3. 檢查缺少項目、資料漂移與識別碼不一致。
4. 對任何建議的建立或更新動作逐一明確確認。
5. 只有在你看懂 diff 之後，才進行寫入。

對 asc-revenuecat-catalog-sync for Ecommerce 而言，最大的品質提升來自把識別碼視為事實來源，並避免產品上線後臨時改名。

在 skill 文字裡檢查 repository 的規則手冊

執行前，請先在 SKILL.md 裡確認三件事：

• 安全預設：不刪除，且寫入前要明確確認
• 失敗處理：逐項繼續，並彙總失敗結果
• 標準對應：productId 應該對上 store_identifier

這些規則，才是讓這個 skill 能在正式環境使用，而不只是 demo 裡方便的原因。

asc-revenuecat-catalog-sync 技能 FAQ

asc-revenuecat-catalog-sync 只適用 RevenueCat 使用者嗎？

不是。它是給同時使用 App Store Connect 與 RevenueCat 的團隊，尤其是在兩者之間需要乾淨對應層時使用。如果你沒有使用 RevenueCat MCP，這個 skill 的幫助就很有限。

如果我的 catalog 很亂，還能用嗎？

可以，但通常要先從 audit mode 和人工審查開始。這個 skill 的設計目的是把 drift 和缺少項目找出來，不是神奇地推斷每一個模糊的對應關係。

這比一般提示詞更好嗎？

通常是。一般提示詞可以描述目標，但 asc-revenuecat-catalog-sync skill 內建了重要的營運限制：驗證、穩定識別碼、先稽核、以及不刪除的安全性。這能降低不小心造成 catalog 漂移的風險。

最常卡住採用的是什麼？

最常見的是缺少驗證、缺少 app ID 或 project ID，以及識別碼策略不清楚。如果你無法確認 ASC productId 對上 RevenueCat store_identifier 的映射，整個同步就會變成猜測，輸出品質也會很快下降。

如何改進 asc-revenuecat-catalog-sync 技能

提供精確的來源資料

最有效的改進，就是把輸入整理乾淨。請用結構化清單送出目前的 ASC catalog、目前的 RevenueCat catalog，以及任何已知的 mapping table。當 asc-revenuecat-catalog-sync skill 能直接比對精確識別碼，而不是讀取像「月費方案」或「高級方案」這種描述文字時，表現會好很多。

先講清楚你要變更的範圍

告訴 skill 你想要的是：

• 只做 audit
• 建立缺少的 ASC 項目
• 將既有項目對應到 RevenueCat
• 為某次發版做完整 reconciliation

這個範圍選擇，會改變模型該優先最佳化什麼。若不先說明，skill 可能會過度準備寫入方案，但你其實只想要一份 drift 報告。

把不一致當成流程問題，不要先當成命名問題

如果結果看起來不對，問題常常不是命名，而是不穩定的 ID、缺少驗證，或來源資料不完整。先把這些補齊，再重新執行。對 asc-revenuecat-catalog-sync usage 來說，最有用的迭代通常是收緊識別碼再重跑 audit mode，而不是要求更大範圍的發想。

先要一份 diff，再逐項驗證

很好的第二輪做法，是要求一份簡潔清單，列出：

• 缺少的 ASC 項目
• 沒有 ASC 對應的 RevenueCat 項目
• 識別碼衝突
• 建議的建立／更新動作

這種格式更容易審核與核准變更，尤其是在電商訂閱 catalog 裡，細小的不一致也可能引發實際的計費與權限問題。