app-store-connect-cli-skills
무엇인가
asc CLI(`asc`)를 통해 App Store 배포 작업을 수행하는 Agent Skills 모음이다. 앱 등록, 빌드·아카이브, TestFlight 업로드, 메타데이터 동기화, 심사 제출, 코드 서명, Apple Ads 운영을 각각 독립된 스킬로 분리한 스킬 팩이며, 커뮤니티가 유지하는 Apple 비공식 배포판이다. Agent Skills 포맷을 따르므로 이 포맷을 읽는 에이전트에서 동작한다.
어떻게 동작하나
각 스킬은 디렉터리 단위로 배치되고, 에이전트가 어떤 상황에서 호출해야 하는지를 적은 설명과 예제 명령으로 구성된다. 실제 실행은 `asc` 바이너리가 담당하고, 스킬은 명령·플래그 조합과 순서를 규정한다. `asc-workflow`는 `.asc/workflow.json`에 저장된 repo-local 자동화 그래프를 실행하며 `before_all`, `after_all`, `error` 훅과 `if` 조건, private helper sub-workflow를 지원한다. 실행 전 `asc workflow validate`가 사이클과 참조를 검사하고, 출력은 CI와 에이전트가 파싱할 수 있도록 JSON 우선으로 나온다. 이름만 있는 대상은 `asc-id-resolver`가 앱·빌드·버전·그룹·테스터 ID로 변환한다.
무엇과 다른가
Fastlane의 lane 기반 자동화를 저장소 안 JSON 그래프로 대체한다. App Store Connect 화면을 사람이 조작하는 대신 `asc` 명령으로 같은 작업을 수행하고, API가 존재하지 않는 앱 레코드 생성만 브라우저 자동화로 처리한다. 릴리스 단계는 `asc release stage`, `asc review submit`, `asc publish appstore`로 나뉘고, 실패 진단·모니터링·취소·재시도는 `asc-submission-health`가 맡는다. 서명 자산은 `asc-signing-setup`이 번들 ID·capability·인증서·프로비저닝 프로파일·암호화된 서명 동기화로 다룬다.
어떻게 쓰나
설치는 `asc`로 스킬을 넣거나 Agent Skills installer로 GitHub에서 직접 받는다. Claude Code에서는 이 저장소를 marketplace로 한 번 추가한 뒤 `asc` 플러그인을 설치하고, Codex는 저장소에 포함된 플러그인 매니페스트를 사용한다. 스크린샷 크기 확인은 `asc screenshots sizes`, 프레임 장치 목록은 `asc screenshots list-frame-devices`, 워크플로 검증은 `asc workflow validate`로 시작한다.
전제와 한계
macOS 환경을 전제로 하며 `xcodebuild`, `simctl`, `sips`를 호출하는 스킬이 포함된다. 앱 생성 스킬은 실제 브라우저에서 App Store Connect 로그인을 요구한다. Apple Ads 변경은 읽기 우선 계획을 거친 뒤 실행하도록 되어 있고, `asc distribute`와 `asc screenshots frame`은 실험 단계로 표시되어 있다. 스크린샷 프레이밍은 `koubou==0.18.1` 버전에 고정되어 있다.