JaminZhou/asc-tooling

asc-tooling은(는) 무엇을 하나요?

이 스킬은 asc_tooling(재사용 가능한 App Store Connect CLI 툴킷) 작업 시 사용합니다.

안전 규칙

• 사용자에게 .p8 키 내용, JWT, 쿠키, App Store Connect 계정 데이터, 또는 공개되지 않은 제품 비밀을 입력하도록 요청하지 마십시오.
• 제품별 스크린샷 생성, 리뷰 노트, 메타데이터 파일, 릴리스 상태는 소비하는 제품 저장소에서 유지하십시오.
• experimental/ 브라우저 세션 헬퍼는 로컬 전용이며 지원되지 않습니다. CI나 공유 릴리스 스크립트에서 사용하지 마십시오.
• 변경 명령어는 반드시 명시적이어야 합니다. App Store Connect 상태를 생성하거나 업데이트하는 작업 전에는 --dry-run을 우선 사용하십시오.
• Apple API 동작이 불확실한 경우, 확인된 사항과 여전히 수동 App Store Connect 확인이 필요한 사항을 보고하십시오.

CLI 진입점

가능하면 통합 CLI를 우선 사용하십시오:

asc-tooling commands
asc-tooling review status --bundle-id com.example.app
asc-tooling metadata status --bundle-id com.example.app --locale en-US
asc-tooling beta status --bundle-id com.example.app
asc-tooling sales units --bundle-id com.example.app --vendor-number 12345678 --report-date 2026-04-10
asc-tooling screenshots status --bundle-id com.example.app --locale en-US --display-type APP_DESKTOP
asc-tooling iap status --bundle-id com.example.app
asc-tooling version create --bundle-id com.example.app --version 1.2.0 --platform ios --dry-run
asc-tooling availability status --bundle-id com.example.app
asc-tooling store-setup status --bundle-id com.example.app --app-version 1.0.0 --platform ios

기존 실행 파일 이름도 계속 지원됩니다:

• asc-review
• asc-metadata
• asc-beta
• asc-sales
• asc-screenshots
• asc-iap
• asc-version
• asc-availability
• asc-store-setup

환경 변수

대부분의 명령어는 App Store Connect API 자격 증명이 필요합니다:

export ASC_KEY_ID=...
export ASC_ISSUER_ID=...
export ASC_KEY_PATH=~/.config/appstoreconnect/AuthKey_XXXX.p8

asc-sales는 --vendor-number로 전달되지 않는 한 ASC_VENDOR_NUMBER도 필요합니다.

워크플로우

1. 제품 저장소와 명령어 표면(리뷰, 메타데이터, 베타, 판매, 스크린샷, IAP, 버전, 제공 여부, 스토어 설정)을 식별합니다.
2. 먼저 제품 로컬 릴리스 문서나 스크립트를 읽고, 제품별 값은 그곳에 유지합니다.
3. 변경 명령어 전에 상태 확인 또는 dry-run 명령어를 사용합니다.
4. 실행한 명령어, 사용된 입력값, 신뢰 출처, 그리고 여전히 필요한 App Store Connect 웹 UI 확인 사항을 요약합니다.
5. 비밀 또는 브라우저 세션 내보내기를 저장소에 저장하지 마십시오.

스킬 설치

번들 CLI를 통해 이 스킬을 설치하거나 업데이트하십시오:

asc-tooling init --client codex --force
asc-tooling init --client agents --force
asc-tooling init --client claude --force
asc-tooling init --print

--client codex는 $CODEX_HOME/skills 또는 ~/.codex/skills에 설치합니다. --client agents는 공용 Agent Skills 사용자 폴더, ~/.agents/skills에 설치합니다. --client claude는 $CLAUDE_CONFIG_DIR/skills 또는 ~/.claude/skills에 설치합니다.