Communitygithub.com

appstore-release

단일 설정 파일을 사용하여 일관되고 안정적인 릴리스 파이프라인으로 iOS 앱 심사를 App Store Connect에 자동 제출합니다.

appstore-release란 무엇인가요?

이 스킬은 EAS/Expo로 빌드된 iOS 앱의 App Store 심사 제출 전 과정을 App Store Connect API를 통해 자동화합니다. 개발자는 ASC API 키, 앱 ID, 설정 파일만 한 번 제공하면, 에이전트가 바이너리 업로드, 메타데이터 및 스크린샷 기입, 가격 및 연령 등급 설정, 콘텐츠 권한 및 리뷰 정보 입력, 구독 연결, 심사 제출까지 가능한 모든 작업을 수행합니다. Apple이 API로 제공하지 않는 앱 개인정보 데이터 수집 선언과 첫 구독 연결 및 제출이라는 두 가지 UI 전용 단계만 사용자에게 정확한 클릭 위치를 알려주며 안내합니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, idempotent하게 설계되어 명령어를 반복 실행해도 안전하고 설정 파일만 수정하면 어떤 앱이든 동작합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add threelipped-genushesperiphona524/appstore-release

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

App Store Release

App Store Connect API를 통해 iOS App Store 제출 전체 과정을 자동화합니다. 설계 목표: 사용자가 자격 증명 + config.json을 한 번 제공하면, 에이전트가 자동화 가능한 모든 작업을 수행하고 Apple이 진정으로 API로 제공하지 않는 몇 가지 작업에 대해서만 사용자에게 알립니다. 이미 설정 파일에 있거나 합리적인 기본값이 있는 항목을 사용자에게 다시 확인하도록 요청하지 마십시오.

작동 원칙 (먼저 읽으십시오)

  1. 프롬프트 기반이 아닌 설정 기반입니다. 모든 앱 콘텐츠는 config.json에 저장됩니다. 명령어를 실행하세요. 사용자에게 인터뷰하지 마십시오.
  2. UI로만 가능한 작업은 두 가지뿐입니다 (Apple에 API 없음): 앱 개인정보 데이터 수집과 첫 번째 구독 연결 및 제출입니다. 도구가 이를 감지하고 정확한 클릭 위치를 알려줍니다. 나머지는 모두 스크립트로 처리됩니다.
  3. 다음 경우에만 사용자에게 질문하십시오: 설정 파일에 필수 필드가 누락된 경우(정확히 어떤 필드인지 알려줌), 설정 파일에 없는 비즈니스 결정(구독 가격, 릴리스 타이밍)이 필요한 경우, 또는 되돌릴 수 없는 최종 작업(제출) 직전. 그 외에는 계속 진행하십시오.
  4. 멱등성(idempotent): 모든 명령어는 다시 실행해도 안전합니다. node cli.mjs release는 반복 실행할 수 있습니다.

아키텍처 (SOLID, 확장 가능)

scripts/
  cli.mjs                 단일 진입점 / 디스패처 (node cli.mjs <command>)
  lib/                    주입된 서비스, 각각 하나의 책임
    env.mjs               환경 변수 파싱 + 검증 (자격 증명, 앱 ID)
    jwt.mjs               ES256 토큰 제공자
    client.mjs            AscClient — 인증 + HTTP + 일관된 오류 처리
    discovery.mjs         자연 키로 ASC 리소스 찾기 (하드코딩된 ID 없음)
    assets.mjs            예약→업로드→커밋 바이너리 업로더
    config.mjs            설정 파일 로드 + 검증, 누락된 항목 나열
    log.mjs               구조화된 결과 + 기계 판독 가능 요약
    context.mjs           구성 루트 (의존성 주입)
  commands/               작업당 하나의 파일; 균일한 계약 (_contract.md 참조)

기능 추가 = commands/x.mjs (meta + run(ctx))를 추가하고 cli.mjs에 등록하십시오.

설정 (최초 1회) — references/setup.md 참조

  1. ASC API 키 (App Manager): AuthKey_XXXX.p8 다운로드, Key ID + Issuer ID 기록.
  2. ASC에 앱 레코드가 존재해야 함 (번들 ID 등록됨). ASC_APP_ID = 앱 ASC URL의 숫자 ID.
  3. EAS 프로젝트가 설정되고 eas login이 완료되어야 함.
  4. references/config-template.json에서 config.json을 채우십시오. 언제든지 검증: 모든 명령어가 정확히 어떤 필드가 누락되었는지 출력합니다.

환경 변수

export ASC_KEY_ID=... ASC_ISSUER_ID=... ASC_P8_PATH=/abs/AuthKey_XXXX.p8   # gitignore the .p8
export ASC_APP_ID=1234567890
export APPSTORE_CONFIG=/abs/config.json
cd scripts   # 그런 다음: node cli.mjs <command>

실행 가이드

1. 상태 확인

node cli.mjs status          # 전체 읽기 전용 개요
node cli.mjs check           # 준비 상태 + 아직 완료되지 않은 UI 전용 단계

2. 바이너리 빌드 (EAS)

  • eas build가 만료된 자격 증명으로 실패하는 경우 ("프로비저닝 프로필 만료 / 일련 번호가 있는 인증서 없음…"):
    node cli.mjs credentials     # 새 배포 인증서 + 프로필 → credentials.json
    
    그런 다음 eas.json 프로덕션 프로필에 "credentialsSource":"local"을 설정하십시오.
  • 바이너리 빌드 + 제출 (비대화형을 위해 EXPO_ASC_API_KEY_PATH/KEY_ID/ISSUER_ID + EXPO_APPLE_TEAM_ID + EXPO_APPLE_TEAM_TYPE 내보내기):
    eas build -p ios --profile production --non-interactive --no-wait
    eas submit -p ios --profile production --id <buildId>
    
    빌드가 VALID 상태가 될 때까지 기다리십시오 (node cli.mjs status).

3. 한 번에 전체 리스팅 작성

node cli.mjs release         # 빌드 연결 → 메타데이터 → 가격 → 콘텐츠 권한 →
                             # 연령 등급 → 카테고리 → 리뷰 정보 → 스크린샷 →
                             # 구독 → 검증

release는 전체 파이프라인을 실행하고(멱등적) check로 끝나며, 남은 UI 전용 단계를 출력합니다. 스크린샷은 먼저 존재해야 합니다 (config.screenshots.dir) — 생성 방법은 references/screenshots.md를 참조하십시오.

4. 두 가지 UI 전용 단계 (정확한 클릭 위치 전달)

check는 해당되는 경우 이를 나열합니다:

  1. 앱 개인정보 → 데이터 수집: 앱의 개인정보 매니페스트와 일치하는 데이터 유형을 선언한 다음 게시하십시오. ⚠️ 바이너리에 NSUserTrackingUsageDescription이 포함되어 있지만 추적을 선언하지 않으면 게시가 차단됩니다 → 키를 제거하고 다시 빌드하십시오 (references/gotchas.md).
  2. 첫 번째 구독: 버전 페이지 → 인앱 구매 및 구독 → 선택 → <제품> → 저장 → 리뷰에 추가 → 제출. (API는 첫 번째 구독을 연결할 수 없습니다.)

5. 제출

node cli.mjs check                 # 누락된 항목이 없는지 확인
node cli.mjs submit --submit       # 앱 전용 / 업데이트 (첫 번째 IAP 제외)

첫 번째 구독의 경우 사용자가 UI에서 제출합니다 (4.2단계). status로 확인: 버전과 구독 모두 WAITING_FOR_REVIEW여야 합니다.

거부 처리

거부 시 버전이 다시 편집 가능해집니다 (REJECTED/METADATA_REJECTED/DEVELOPER_REJECTED). 해결 센터 메시지를 읽고 수정한 후(메타데이터는 release 사용, 바이너리 문제는 재빌드) 다시 제출하십시오.

참고 자료

  • references/setup.md — 키 생성, 앱 레코드, EAS, 시크릿 관리.
  • references/gotchas.md — 모든 실제 문제점 (첫 실행 전에 읽으십시오).
  • references/screenshots.md — 정확한 크기의 PNG 생성 (HTML → 헤드리스 Chrome).
  • references/config-template.json — 앱별 설정 (lib/config.mjs에서 검증됨).

관련 스킬