Xcode MCP 사용 지침

--- name: xcode-mcp description: Xcode MCP 도구 효율적 사용을 위한 지침. 이 스킬은 Xcode MCP 도구를 사용해야 하는 시점과 표준 도구를 선호해야 하는 시점을 이해하는 데 사용됨. Xcode MCP는 많은 토큰을 소비하므로 빌드, 테스트, 시뮬레이터, 프리뷰, SourceKit 진단에만 사용. 파일 읽기/쓰기/grep 작업에는 절대 사용하지 말 것. --- # Xcode MCP 사용 지침 Xcode MCP 도구는 상당한 토큰을 소비합니다. 이 스킬은 Xcode MCP를 사용해야 하는 시점과 표준 도구를 선호해야 하는 시점을 정의합니다. ## 전체 Xcode MCP 도구 참조 ### 창 및 프로젝트 관리 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__XcodeListWindows` | 열린 Xcode 창 나열 (tabIdentifier 확보) | 낮음 | ### 빌드 작업 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__BuildProject` | Xcode 프로젝트 빌드 | 중간 | | `mcp__xcode__GetBuildLog` | 오류/경고가 포함된 빌드 로그 확보 | 중간 | | `mcp__xcode__XcodeListNavigatorIssues` | Issue Navigator의 문제 나열 | 낮음 | ### 테스트 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__GetTestList` | 테스트 플랜에서 사용 가능한 테스트 확보 | 낮음 | | `mcp__xcode__RunAllTests` | 모든 테스트 실행 | 중간 | | `mcp__xcode__RunSomeTests` | 특정 테스트 실행 (선호됨) | 중간 | ### 프리뷰 및 실행 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__RenderPreview` | SwiftUI 프리뷰 스냅샷 렌더링 | 중간 | | `mcp__xcode__ExecuteSnippet` | 파일 컨텍스트에서 코드 스니펫 실행 | 중간 | ### 진단 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__XcodeRefreshCodeIssuesInFile` | 특정 파일에 대한 컴파일러 진단 확보 | 낮음 | | `mcp__ide__getDiagnostics` | SourceKit 진단 확보 (열린 모든 파일) | 낮음 | ### 문서 | 도구 | 설명 | 토큰 비용 | |------|-------------|------------| | `mcp__xcode__DocumentationSearch` | Apple 개발자 문서 검색 | 낮음 | ### 파일 작업 (높은 토큰 - 절대 사용 금지) | 도구 | 대안 | 이유 | |------|-------------|-----| | `mcp__xcode__XcodeRead` | `Read` 도구 | 높은 토큰 소비 | | `mcp__xcode__XcodeWrite` | `Write` 도구 | 높은 토큰 소비 | | `mcp__xcode__XcodeUpdate` | `Edit` 도구 | 높은 토큰 소비 | | `mcp__xcode__XcodeGrep` | `rg` / `Grep` 도구 | 높은 토큰 소비 | | `mcp__xcode__XcodeGlob` | `Glob` 도구 | 높은 토큰 소비 | | `mcp__xcode__XcodeLS` | `ls` 명령 | 높은 토큰 소비 | | `mcp__xcode__XcodeRM` | `rm` 명령 | 높은 토큰 소비 | | `mcp__xcode__XcodeMakeDir` | `mkdir` 명령 | 높은 토큰 소비 | | `mcp__xcode__XcodeMV` | `mv` 명령 | 높은 토큰 소비 | --- ## 권장 워크플로우 ### 1. 코드 변경 및 빌드 흐름 ``` 1. 코드 검색 -> rg "pattern" --type swift 2. 파일 읽기 -> Read 도구 3. 파일 편집 -> Edit 도구 4. 구문 검사 -> mcp__ide__getDiagnostics 5. 빌드 -> mcp__xcode__BuildProject 6. 오류 확인 -> mcp__xcode__GetBuildLog (빌드 실패 시) ``` ### 2. 테스트 작성 및 실행 흐름 ``` 1. 테스트 파일 읽기 -> Read 도구 2. 테스트 작성/편집 -> Edit 도구 3. 테스트 목록 확보 -> mcp__xcode__GetTestList 4. 테스트 실행 -> mcp__xcode__RunSomeTests (특정 테스트) 5. 결과 확인 -> 테스트 출력 검토 ``` ### 3. SwiftUI 프리뷰 흐름 ``` 1. 뷰 편집 -> Edit 도구 2. 프리뷰 렌더링 -> mcp__xcode__RenderPreview 3. 반복 -> 필요에 따라 반복 ``` ### 4. 디버그 흐름 ``` 1. 진단 확인 -> mcp__ide__getDiagnostics (빠른 구문 검사) 2. 프로젝트 빌드 -> mcp__xcode__BuildProject 3. 빌드 로그 확보 -> mcp__xcode__GetBuildLog (심각도: 오류) 4. 문제 수정 -> Edit 도구 5. 재빌드 -> mcp__xcode__BuildProject ``` ### 5. 문서 검색 ``` 1. 문서 검색 -> mcp__xcode__DocumentationSearch 2. 결과 검토 -> 구현에 정보 사용 ``` --- ## 대체 명령 (MCP 사용 불가 시) Xcode MCP가 연결 해제되거나 사용 불가능한 경우, 다음 xcodebuild 명령을 사용하세요: ### 빌드 명령 ```bash # 디버그 빌드 (시뮬레이터) - <SchemeName>을 프로젝트의 스킴으로 교체 xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # 릴리즈 빌드 (기기) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # 워크스페이스로 빌드 (CocoaPods 프로젝트용) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # 프로젝트 파일로 빌드 xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # 사용 가능한 스킴 나열 xcodebuild -list ``` ### 테스트 명령 ```bash # 모든 테스트 실행 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination"platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # 특정 테스트 클래스 실행 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination"platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # 특정 테스트 메서드 실행 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination"platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # 코드 커버리지로 실행 xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # 사용 가능한 시뮬레이터 나열 xcrun simctl list devices available ``` ### 클린 빌드 ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## 빠른 참조 ### Xcode MCP 사용 대상: - `BuildProject` - 빌드 - `GetBuildLog` - 빌드 오류 - `RunSomeTests` - 특정 테스트 실행 - `GetTestList` - 테스트 나열 - `RenderPreview` - SwiftUI 프리뷰 - `ExecuteSnippet` - 코드 실행 - `DocumentationSearch` - Apple 문서 - `XcodeListWindows` - tabIdentifier 확보 - `mcp__ide__getDiagnostics` - SourceKit 오류 ### Xcode MCP 절대 사용 금지 대상: - `XcodeRead` -> `Read` 도구 사용 - `XcodeWrite` -> `Write` 도구 사용 - `XcodeUpdate` -> `Edit` 도구 사용 - `XcodeGrep` -> `rg` 또는 `Grep` 도구 사용 - `XcodeGlob` -> `Glob` 도구 사용 - `XcodeLS` -> `ls` 명령 사용 - `XcodeRM` -> `rm` 명령 사용 - `XcodeMakeDir` -> `mkdir` 명령 사용 - `XcodeMV` -> `mv` 명령 사용 - 파일 작업 -> 표준 도구 사용 --- ## 토큰 효율성 요약 | 작업 | 최선의 선택 | 토큰 영향 | |-----------|-------------|--------------| | 빠른 구문 검사 | `mcp__ide__getDiagnostics` | 낮음 | | 전체 빌드 | `mcp__xcode__BuildProject` | 중간 | | 특정 테스트 실행 | `mcp__xcode__RunSomeTests` | 중간 | | 모든 테스트 실행 | `mcp__xcode__RunAllTests` | 높음 | | 파일 읽기 | `Read` 도구 | 높음 | | 파일 편집 | `Edit` 도구 | 높음 | | 코드 검색 | `rg` / `Grep` | 낮음 | | 파일 나열 | `ls` / `Glob` | 낮음 |