For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
기본 탐색
Codex

Codex use case

iOS 시뮬레이터에서 디버깅

Codex와 XcodeBuildMCP를 사용해 iOS 시뮬레이터에서 앱을 조작하고 증거를 수집하며, 문제를 해결할 때까지 반복하세요.

Difficulty 고급
Time horizon 1시간

Codex를 사용해 적합한 Xcode 스킴과 시뮬레이터를 찾고, 앱을 실행하고, UI 트리를 검사하고, 탭·입력·스와이프를 수행하고, 스크린샷과 로그를 수집하고, 필요할 때 LLDB를 연결하여 모호한 버그 보고서를 검증된 작은 수정 사항으로 바꾸세요.

적합한 대상

  • 시뮬레이터에서 특정 탭, 스크롤 또는 양식 입력 경로를 거친 뒤에만 나타나는 UI 버그
  • Codex가 코드를 수정하기 전에 로그, 스크린샷, 뷰 계층 구조 상태, 디버거 백트레이스를 확인해야 하는 충돌, 멈춤 또는 내비게이션 오류
  • 모든 상태를 사람이 직접 클릭해 확인하도록 하는 대신 Codex가 재현-수정-검증 루프를 전담하길 원하는 팀

Contents

    ← 모든 사용 사례

    iOS 시뮬레이터에서 디버깅

    Codex와 XcodeBuildMCP를 사용해 iOS 시뮬레이터에서 앱을 조작하고 증거를 수집하며, 문제를 해결할 때까지 반복하세요.

    Codex를 사용해 적합한 Xcode 스킴과 시뮬레이터를 찾고, 앱을 실행하고, UI 트리를 검사하고, 탭·입력·스와이프를 수행하고, 스크린샷과 로그를 수집하고, 필요할 때 LLDB를 연결하여 모호한 버그 보고서를 검증된 작은 수정 사항으로 바꾸세요.

    고급
    1시간

    Codex를 사용해 적합한 Xcode 스킴과 시뮬레이터를 찾고, 앱을 실행하고, UI 트리를 검사하고, 탭·입력·스와이프를 수행하고, 스크린샷과 로그를 수집하고, 필요할 때 LLDB를 연결하여 모호한 버그 보고서를 검증된 작은 수정 사항으로 바꾸세요.

    고급
    1시간

    적합한 대상

    • 시뮬레이터에서 특정 탭, 스크롤 또는 양식 입력 경로를 거친 뒤에만 나타나는 UI 버그
    • Codex가 코드를 수정하기 전에 로그, 스크린샷, 뷰 계층 구조 상태, 디버거 백트레이스를 확인해야 하는 충돌, 멈춤 또는 내비게이션 오류
    • 모든 상태를 사람이 직접 클릭해 확인하도록 하는 대신 Codex가 재현-수정-검증 루프를 전담하길 원하는 팀

    스킬 및 플러그인

    • iOS 디버거 에이전트를 사용해 XcodeBuildMCP로 시뮬레이터에서 앱을 빌드, 실행, 검사 및 조작한 다음, Codex가 버그 범위를 좁혀 가는 동안 로그, 스크린샷, 스택 트레이스를 수집하세요.
    Skill Why use it
    Build iOS Apps iOS 디버거 에이전트를 사용해 XcodeBuildMCP로 시뮬레이터에서 앱을 빌드, 실행, 검사 및 조작한 다음, Codex가 버그 범위를 좁혀 가는 동안 로그, 스크린샷, 스택 트레이스를 수집하세요.

    시작 프롬프트

    Build iOS Apps 플러그인과 XcodeBuildMCP를 사용해 이 버그를 시뮬레이터에서 직접 재현하고, 근본 원인을 진단한 뒤, 작은 범위의 수정 사항을 구현하세요. 버그 보고서: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 제약 조건: - 먼저 프로젝트, 스킴, 시뮬레이터가 이미 선택되어 있는지 확인하세요. 선택되어 있지 않다면 올바른 Xcode 프로젝트 또는 워크스페이스를 찾고, 앱 스킴과 시뮬레이터를 선택한 뒤 세션의 나머지 과정에서 이 설정을 재사용하세요. - 시뮬레이터에서 앱을 빌드하고 실행한 다음, 상호작용을 시작하기 전에 UI 스냅샷이나 스크린샷으로 올바른 화면이 표시되는지 확인하세요. - 시뮬레이터에서 탭, 입력, 스크롤, 스와이프를 수행해 정확한 재현 경로를 직접 진행하세요. 원시 좌표보다 접근성 레이블이나 ID를 우선 사용하고, 레이아웃이 변경되면 다음 작업 전에 UI 계층 구조를 다시 읽으세요. - 디버깅하는 동안 증거를 수집하세요. 시각적 상태를 보여 주는 스크린샷, 문제 발생 전후의 시뮬레이터 로그, 버그가 충돌이나 멈춤으로 보일 경우 LLDB 스택 프레임이나 변수를 수집하세요. - 시뮬레이터가 아직 부팅되지 않았다면 하나를 부팅하고 선택한 기기와 OS를 알려 주세요. 자격 증명이나 특수한 픽스처가 필요하면 잠시 멈추고 누락된 입력만 요청하세요. - 버그를 해결하는 데 필요한 최소한의 코드만 변경한 다음, 시뮬레이터 플로우를 다시 실행하고 수정 사항을 정확히 어떻게 검증했는지 알려 주세요. 제공할 내용: - Codex가 실행한 재현 단계 - 버그를 설명하는 데 핵심이 된 스크린샷, 로그 또는 스택 세부 정보 - 코드 수정 사항과 해당 수정이 작동하는 이유 - 최종 검증에 사용한 시뮬레이터와 스킴
    Build iOS Apps 플러그인과 XcodeBuildMCP를 사용해 이 버그를 시뮬레이터에서 직접 재현하고, 근본 원인을 진단한 뒤, 작은 범위의 수정 사항을 구현하세요. 버그 보고서: [Describe the expected behavior, the actual bug, and any known screen or account setup.] 제약 조건: - 먼저 프로젝트, 스킴, 시뮬레이터가 이미 선택되어 있는지 확인하세요. 선택되어 있지 않다면 올바른 Xcode 프로젝트 또는 워크스페이스를 찾고, 앱 스킴과 시뮬레이터를 선택한 뒤 세션의 나머지 과정에서 이 설정을 재사용하세요. - 시뮬레이터에서 앱을 빌드하고 실행한 다음, 상호작용을 시작하기 전에 UI 스냅샷이나 스크린샷으로 올바른 화면이 표시되는지 확인하세요. - 시뮬레이터에서 탭, 입력, 스크롤, 스와이프를 수행해 정확한 재현 경로를 직접 진행하세요. 원시 좌표보다 접근성 레이블이나 ID를 우선 사용하고, 레이아웃이 변경되면 다음 작업 전에 UI 계층 구조를 다시 읽으세요. - 디버깅하는 동안 증거를 수집하세요. 시각적 상태를 보여 주는 스크린샷, 문제 발생 전후의 시뮬레이터 로그, 버그가 충돌이나 멈춤으로 보일 경우 LLDB 스택 프레임이나 변수를 수집하세요. - 시뮬레이터가 아직 부팅되지 않았다면 하나를 부팅하고 선택한 기기와 OS를 알려 주세요. 자격 증명이나 특수한 픽스처가 필요하면 잠시 멈추고 누락된 입력만 요청하세요. - 버그를 해결하는 데 필요한 최소한의 코드만 변경한 다음, 시뮬레이터 플로우를 다시 실행하고 수정 사항을 정확히 어떻게 검증했는지 알려 주세요. 제공할 내용: - Codex가 실행한 재현 단계 - 버그를 설명하는 데 핵심이 된 스크린샷, 로그 또는 스택 세부 정보 - 코드 수정 사항과 해당 수정이 작동하는 이유 - 최종 검증에 사용한 시뮬레이터와 스킴

    시뮬레이터 전체 루프를 Codex에 맡기기

    이 사용 사례는 Codex가 전체 루프를 맡을 때 가장 효과적입니다. 올바른 앱 타깃을 선택하고, 시뮬레이터에서 앱을 실행하고, 현재 화면을 검사하고, 재현 단계를 수행하고, 로그와 스크린샷을 수집하고, 필요하면 스택 트레이스를 확인하고, 코드를 패치한 뒤, 같은 경로를 다시 실행해 버그가 사라졌음을 입증합니다.

    이 루프를 에이전트 기반으로 유지하려면 Build iOS Apps 플러그인을 사용하세요. 이 플러그인의 iOS 디버거 워크플로우는 XcodeBuildMCP를 기반으로 하므로 Codex는 부팅된 시뮬레이터와 상호작용하며, 일반적으로 사람이 직접 수집하는 것과 동일한 증거를 수집할 수 있습니다.

    XcodeBuildMCP에 시뮬레이터 자동화, UI 자동화, 디버깅, 로깅 워크플로우를 구성하면 Codex가 재현-디버깅-검증 루프 전체를 맡을 수 있습니다. Codex가 아직 프로젝트, 스킴, 시뮬레이터를 선택하지 않았다면 먼저 이를 찾게 하고 나머지 세션 동안 해당 설정을 재사용하도록 요청하세요.

    XcodeBuildMCP의 기능 활용하기

    Codex에 사용하도록 요청할 수 있는 실용적인 기능 그룹은 다음과 같습니다:

    • 프로젝트 및 시뮬레이터 탐색: Codex가 사용할 앱 타깃과 시뮬레이터를 이미 알고 있는지 확인하고, Xcode 프로젝트나 워크스페이스를 찾고, 스킴 목록을 확인하고, 시뮬레이터를 찾거나 부팅하며, 이후 빌드/실행 단계에서도 이 설정이 유지되도록 합니다.
    • 빌드 및 실행 제어: 활성 앱 타깃을 빌드하고, 시뮬레이터용 빌드를 설치하여 실행하고, 필요하면 로그 수집을 활성화한 상태로 재실행하며, Codex가 앱별 런타임 로그를 검사해야 할 때는 앱 번들 ID를 확인합니다.
    • UI 검사 및 상호작용: 화면의 접근성 계층 구조를 읽고, 스크린샷을 찍고, 컨트롤을 탭하고, 필드에 입력하고, 목록을 스크롤하며, 화면 가장자리 스와이프나 기타 시뮬레이터 제스처를 수행합니다.
    • 로그 및 디버거 상태: 시뮬레이터 로그를 스트리밍하고, 실행 중인 앱에 LLDB를 연결하고, 중단점을 설정하고, 스택 프레임과 로컬 변수를 검사하며, 충돌이나 멈춤을 더 자세히 조사해야 할 때 디버거 명령을 실행합니다.

    중요한 습관은 Codex가 탭하기 전에 뷰 트리를 검사하도록 하는 것입니다. XcodeBuildMCP는 접근성 계층 구조와 좌표를 제공하므로 Codex는 원시 화면 위치를 추측하는 대신 안정적인 레이블이나 요소 ID를 우선 사용할 수 있습니다.

    모호한 버그를 재현 가능한 스크립트로 만들기

    iOS 디버거 스킬은 프롬프트에 구체적인 버그 하나와 예상 결과 하나를 제시한 다음, Codex가 앱을 조작하고 자율적으로 증거를 수집하도록 할 때 가장 효과적입니다. 로그인, 딥 링크 또는 테스트 픽스처가 필요하다면 이를 한 번만 알려 주고, 해당 정보가 없어 진행할 수 없을 때만 Codex가 일시 중지하도록 요청하세요.

    실용적인 팁

    수정뿐 아니라 증거도 요청하기

    Codex가 버그를 설명할 때 사용한 정확한 시뮬레이터와 스킴, 스크린샷, 로그 일부, 스택 세부 정보를 요청하세요. 그러면 "이렇게 하면 수정될 것 같습니다."라는 설명만 있는 경우보다 최종 패치를 훨씬 쉽게 검토할 수 있습니다.

    좌표보다 접근성 레이블 우선 사용하기

    컨트롤에 안정적인 레이블이나 접근성 식별자가 없어 Codex가 좌표로 탭해야 한다면 그 사실을 명시하도록 요청하세요. 이는 UI 테스트 용이성을 조금 개선하는 작업도 버그 수정에 포함해야 한다는 신호인 경우가 많습니다.

    실행 한 번에 버그 하나만 다루기

    시뮬레이터 기반 디버깅 루프는 강력하지만, 프롬프트 하나가 실패 유형 하나에 집중할 때 더 신뢰하기 쉽습니다. 인접한 이슈로 범위를 넓히기 전에 Codex가 하나의 재현-수정-검증 주기를 완료하도록 하세요.

    Tech stack

    Need

    시뮬레이터 자동화

    Default options

    XcodeBuildMCP

    Why it's needed

    현재 도구가 지원하는 범위에는 시뮬레이터 설정, 빌드 및 실행, UI 스냅샷, 탭, 텍스트 입력, 제스처, 스크린샷, 로그 수집, 디버거 연결이 포함됩니다.

    Need

    에이전트 워크플로우

    Why it's needed

    플러그인의 iOS 디버거 에이전트는 Codex가 버그를 재현하고 증거를 수집하며 변경할 때마다 수정 사항을 검증할 수 있도록 시뮬레이터 중심의 명확한 루프를 제공합니다.

    Need

    앱 관측성

    Default options

    Logger, OSLog, LLDB, 시뮬레이터 스크린샷

    Why it's needed

    Codex는 로그와 디버거 상태를 사용해 무엇이 잘못되었는지 설명한 다음, 수정 전후의 정확한 UI 상태를 입증하는 스크린샷을 저장할 수 있습니다.

    Need Default options Why it's needed
    시뮬레이터 자동화 XcodeBuildMCP 현재 도구가 지원하는 범위에는 시뮬레이터 설정, 빌드 및 실행, UI 스냅샷, 탭, 텍스트 입력, 제스처, 스크린샷, 로그 수집, 디버거 연결이 포함됩니다.
    에이전트 워크플로우 Build iOS Apps 플러그인 플러그인의 iOS 디버거 에이전트는 Codex가 버그를 재현하고 증거를 수집하며 변경할 때마다 수정 사항을 검증할 수 있도록 시뮬레이터 중심의 명확한 루프를 제공합니다.
    앱 관측성 Logger , OSLog , LLDB, 시뮬레이터 스크린샷 Codex는 로그와 디버거 상태를 사용해 무엇이 잘못되었는지 설명한 다음, 수정 전후의 정확한 UI 상태를 입증하는 스크린샷을 저장할 수 있습니다.

    관련 사용 사례