conorluddy/ios-simulator-skill

해결하는 문제

이 프로젝트는 AI 에이전트(특히 Claude Code)와 인간 개발자가 Xcode 시뮬레이터 내에서 iOS 앱을 빌드하고 테스트하며 상호작용할 수 있도록 도와주는 자동화 도구 세트를 제공합니다. AI 기반 모바일 개발에서 발생하는 '토큰 과잉'과 취약성 문제를 해결하기 위해, 긴 도구 출력과 좌표 기반 탭을 최적화된 의미적 요약과 접근성 기반 네비게이션으로 대체합니다.

작동 방식

이 스킬은 xcodebuild와 simctl, idb(iOS Debug Bridge) 라이브러리를 래핑하는 29개의 파이썬 및 쉘 스크립트로 구성되어 있습니다.

• 진행적 공개: 거대한 빌드 로그를 출력하는 대신 간결한 요약을 제공하고, 사용자 또는 에이전트가 고유 ID를 사용해 특정 오류나 경고를 요청할 수 있습니다.
• 의미 기반 네비게이션: iOS 접근성 API를 사용해 "로그인"이라는 레이블이 붙은 버튼과 같이 의미에 따라 UI 요소를 찾으며, 불안정한 화면 좌표에 의존하지 않습니다.
• 토큰 최적화: 스크린샷을 자동으로 리사이징하고 압축하며, 긴 로그는 잘라내어 LLM에 전송되는 데이터량을 줄여 토큰 비용을 크게 낮춥니다.
• 환경 제어: 환경 변수를 통해 타임아웃과 출력 제한을 세밀하게 조정 가능해 Apple Silicon 또는 느린 CI 러너와 같은 다양한 하드웨어에 적응할 수 있습니다.

대상 사용자

주로 Claude Code를 사용해 iOS 앱 개발을 자동화하는 개발자, 그리고 iOS 시뮬레이터와 Xcode 빌드를 더 견고하고 스크립트 가능한 방식으로 관리하고자 하는 QA 엔지니어 및 개발자에게 적합합니다.

주요 특징

• 29개의 전용 스크립트: 빌드, 디바이스 상태, 네비게이션, 테스트, 라이프사이클 관리까지 전체 라이프사이클을 커버합니다.
• 접근성 우선의 상호작용: 레이아웃 변경에도 깨지지 않는 강력한 UI 자동화를 제공합니다.
• 토큰 효율적인 출력: 일반적인 작업에서 원본 도구 출력을 최대 99%까지 줄입니다.
• 포괄적인 디바이스 제어: GPS 시뮬레이션, 다크 모드 전환, 푸시 알림 트리거, 권한 관리 기능을 포함합니다.
• 통합 건강 점검: Xcode, Python, idb 설치 상태를 확인하는 기능이 내장되어 있습니다.