asc-revenuecat-catalog-sync

asc-revenuecat-catalog-sync 技能概览

asc-revenuecat-catalog-sync 是一款用于保持 App Store Connect 和 RevenueCat 对齐的工作流技能。它可以帮助你审计漂移、创建缺失的 ASC subscriptions 或 in-app purchases，并将这些项目映射到 RevenueCat 的 products、entitlements、offerings 和 packages，减少大量手工核对。

这个 asc-revenuecat-catalog-sync skill 特别适合已经在某一个系统里建立了 catalog、需要在另一个系统中可靠复刻的电商和订阅团队。它的核心任务不是单独“学习 RevenueCat”或“学习 ASC”，而是把混乱、部分匹配的 catalog 数据整理成一个可预测的同步方案，让你在真正写入变更之前先审阅。

这个技能适合做什么

• 基于现有 ASC catalog 初始化 RevenueCat。
• 在映射到 RevenueCat 之前，先创建缺失的 ASC subscriptions 或 IAPs。
• 在发布或迁移前执行漂移审计。
• 保持稳定标识符，避免线上产品出问题。

它的不同之处

• 它以标识符为驱动，而不是靠猜：ASC productId 是跨系统的主键。
• 它比一次性 prompt 更安全，因为它默认采用先审计、后写入的工作流。
• 对使用 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 开始读。在这个仓库里，没有其他辅助文件夹可供探索，所以 skill 文件本身就是唯一的事实来源。这也意味着第一遍阅读尤其重要：在尝试运行任何内容之前，先关注前置条件、安全默认值和规范的标识符规则。

给技能提供它真正能用的输入

asc-revenuecat-catalog-sync usage 在你提供具体的 catalog 事实时效果最好，而不是只给一个模糊目标。请包含：

• ASC app ID
• RevenueCat project_id
• 目标 app 类型：app_store 或 mac_app_store
• create 流程所需的 bundle ID
• 你希望使用 audit-only 还是 write mode
• 任何已知的 ASC productId 与 RevenueCat store_identifier 映射对

一个好的 prompt 可以这样写：

“请将我的 ASC catalog 与 RevenueCat 做审计比对，app 是 123456789。先使用 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.md 里确认三件事：

• 安全默认值：不删除，写入前必须明确确认
• 失败处理：按条目继续执行，并汇总失败项
• 规范映射：productId 应该匹配 store_identifier

正是这些规则，让这个技能在生产环境里真正可用，而不只是 demo 里看起来方便。

asc-revenuecat-catalog-sync 技能常见问题

这个技能只适合 RevenueCat 用户吗？

不是。它适合同时使用 App Store Connect 和 RevenueCat 的团队，尤其是需要在两者之间建立清晰映射层的时候。如果你并没有使用 RevenueCat MCP，这个技能的帮助不会太大。

catalog 很乱的时候还能用吗？

可以，但你要预期先进入 audit mode 并进行人工审查。这个技能的设计目的，是把漂移和缺失项暴露出来，而不是神奇地推断出每一个模糊映射。

它比通用 prompt 更好吗？

通常是更好。通用 prompt 可以描述目标，但 asc-revenuecat-catalog-sync skill 把关键的操作约束都内置进去了：认证、稳定标识符、先审计、以及不删除的安全策略。这能显著降低意外 catalog 漂移的风险。

最常见的阻碍是什么？

认证缺失、app IDs 或 project IDs 缺失，以及标识符策略不清晰。如果你无法确认 ASC productId 到 RevenueCat store_identifier 的映射，整个同步就会变成猜测，输出质量会迅速下降。

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

提供精确的事实来源数据

最有效的改进，就是把输入整理得更干净。请以结构化列表的形式发送当前 ASC catalog、当前 RevenueCat catalog，以及任何已知的映射表。asc-revenuecat-catalog-sync skill 更擅长比较精确标识符，而不是理解“月度套餐”或“高级 offering”这类口语化描述。

明确你希望变更的范围

告诉技能你想要的是：

• 仅审计
• 创建缺失的 ASC 项
• 将已有项目映射到 RevenueCat
• 面向发布的完整对账

这个范围选择会改变模型应当优化的方向。如果不说明，技能可能会过度准备写入方案，而你其实只想要一份漂移报告。

把不匹配当作工作流问题，而不是命名问题

如果结果看起来不对，问题往往出在不稳定的 ID、认证缺失，或者源数据不完整。先把这些问题修正，再重新运行。对于 asc-revenuecat-catalog-sync usage 来说，最有价值的迭代通常是收紧标识符并重新运行 audit mode，而不是要求更宽泛的头脑风暴。

先要一份 diff，再做验证

很有效的第二轮请求，是让它给出一份简洁的列表，包含：

• 缺失的 ASC 项
• 没有 ASC 匹配的 RevenueCat 项
• 标识符冲突
• 建议的创建/更新操作

这种格式更容易审查和批准变更，尤其是在电商订阅 catalog 里，哪怕很小的不匹配也可能引发真实的计费和权益问题。