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은 한 시스템에 이미 카탈로그가 있는 이커머스 및 구독 팀이 다른 시스템에도 안정적으로 같은 구성을 반영해야 할 때 가장 적합합니다. 핵심 과제는 “RevenueCat을 배운다”거나 “ASC를 배운다”가 아니라, 어수선하고 부분적으로만 매칭된 카탈로그 데이터를 결정적인 동기화 계획으로 정리해 쓰기 전에 검토할 수 있게 만드는 것입니다.

이 스킬이 특히 유용한 경우

• 기존 ASC 카탈로그를 바탕으로 RevenueCat을 초기 구성할 때
• RevenueCat에 매핑하기 전에 누락된 ASC subscriptions 또는 IAPs를 만들 때
• 릴리스나 마이그레이션 전에 드리프트를 점검할 때
• 실제 운영 중인 제품이 깨지지 않도록 안정적인 식별자를 유지할 때

무엇이 다른가

• 추측이 아니라 식별자 중심입니다: ASC productId가 시스템 간 연결의 기본 키입니다.
• 일회성 프롬프트보다 안전합니다. 먼저 audit부터 하는 워크플로우를 전제로 하기 때문입니다.
• 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
• audit-only인지 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. diff를 충분히 이해한 뒤에만 writes를 적용합니다.

asc-revenuecat-catalog-sync for Ecommerce에서 가장 큰 품질 향상은 식별자를 진실의 원천으로 삼고, 제품이 이미 라이브 상태일 때는 즉흥적으로 이름을 바꾸지 않는 데서 나옵니다.

스킬 텍스트에서 저장소 규칙 확인하기

실행하기 전에 SKILL.md에서 다음 세 가지를 확인하세요.

• 안전 기본값: 삭제 없음, writes 전 명시적 확인
• 실패 처리: 항목별로 계속 진행하고 실패를 요약
• 표준 매핑: productId는 store_identifier와 맞춰야 함

이 규칙들이 있어야 이 스킬은 데모용 편의 기능이 아니라 실제 운영에서도 쓸 수 있는 도구가 됩니다.

asc-revenuecat-catalog-sync 스킬 FAQ

RevenueCat 사용자만 쓸 수 있나요?

아닙니다. App Store Connect와 RevenueCat을 함께 쓰는 팀, 특히 두 시스템 사이에 깔끔한 매핑 계층이 필요한 팀을 위한 스킬입니다. RevenueCat MCP를 쓰지 않는다면 이 스킬의 효용은 크지 않습니다.

카탈로그가 엉망이어도 사용할 수 있나요?

가능합니다. 다만 audit mode와 수동 검토부터 시작할 것으로 예상해야 합니다. 이 스킬은 드리프트와 누락 항목을 드러내는 데 초점이 있으며, 애매한 매핑을 전부 알아서 추론해 주도록 설계된 것은 아닙니다.

일반 프롬프트보다 나은가요?

대체로 그렇습니다. 일반 프롬프트도 목표는 설명할 수 있지만, asc-revenuecat-catalog-sync skill에는 인증, 안정적인 식별자, audit-first 동작, delete 금지 안전장치 같은 중요한 운영 제약이 들어 있습니다. 덕분에 실수로 인한 카탈로그 드리프트 가능성이 줄어듭니다.

도입을 가장 자주 막는 요인은 무엇인가요?

인증 누락, app ID나 project ID 누락, 그리고 식별자 전략이 불명확한 경우입니다. ASC productId와 RevenueCat store_identifier의 매핑을 확실히 확인할 수 없다면, 동기화는 추측이 되고 결과 품질은 빠르게 떨어집니다.

asc-revenuecat-catalog-sync 스킬 개선 방법

정확한 단일 기준 데이터 제공하기

가장 좋은 개선은 입력을 더 깨끗하게 만드는 것입니다. 현재 ASC 카탈로그, 현재 RevenueCat 카탈로그, 그리고 알고 있는 매핑 테이블을 구조화된 목록으로 보내세요. asc-revenuecat-catalog-sync skill은 “월간 플랜”이나 “프리미엄 오퍼링” 같은 문장보다, 정확한 식별자를 비교할 수 있을 때 더 잘 작동합니다.

변경 범위를 명확히 말하기

스킬에 원하는 작업 범위를 알려 주세요.

• audit only
• 누락된 ASC 항목 생성
• 기존 항목을 RevenueCat에 매핑
• 릴리스용 전체 정합성 맞추기

이 범위 선택에 따라 모델이 최적화할 대상이 달라집니다. 이를 말하지 않으면, drift report만 원했는데도 write plan을 과하게 준비할 수 있습니다.

불일치는 이름 문제가 아니라 워크플로우 문제로 보기

결과가 이상해 보인다면, 원인은 종종 불안정한 ID, 인증 누락, 또는 불완전한 소스 데이터입니다. 먼저 그것부터 고치고 다시 실행하세요. asc-revenuecat-catalog-sync usage에서 가장 유용한 반복은 대개 더 넓은 브레인스토밍을 요청하는 것이 아니라 식별자를 더 엄격하게 맞춘 뒤 audit mode를 다시 돌리는 것입니다.

diff를 요청한 뒤 검증하기

좋은 두 번째 패스는 다음 항목을 간단히 정리해 달라고 요청하는 것입니다.

• 누락된 ASC 항목
• ASC와 매칭되지 않는 RevenueCat 항목
• 식별자 충돌
• 제안된 create/update 작업

이 형식이면 변경사항을 더 쉽게 검토하고 승인할 수 있습니다. 특히 작은 불일치도 실제 과금과 entitlement 문제로 이어질 수 있는 이커머스 구독 카탈로그에서는 더욱 그렇습니다.