iOS Skills Router
iOS/Swift/Xcode 개발을 위한 200개 이상의 특화 스킬에 접근할 수 있습니다. 스킬은 파일을 편집하거나 명령을 실행할 때 hooks에 의해 자동으로 주입되지만, 언제든지 SKILL.md를 읽어 수동으로 로드할 수도 있습니다.
중요: 코딩 전에 적극적으로 스킬 로드하기
관련 스킬을 먼저 확인하지 않고 코딩을 시작하지 마세요. 이것은 이 라우터에서 가장 중요한 지침입니다.
특정 프레임워크, 도메인 또는 패턴을 다루는 코드를 작성하기 전에:
- import 확인 — 파일이
MapKit,HealthKit,StoreKit등을 import 한다면, 코드를 작성하기 전에skills/dpearson2699--{framework}/SKILL.md를 읽으세요. - 도메인 확인 — 네트워킹 코드를 작성한다면 네트워킹 스킬을 읽으세요. 동시성 코드를 작성한다면 동시성 스킬을 읽으세요. 추측하지 마세요.
- 서드파티 프레임워크 확인 — 프로젝트가 Mapbox, Firebase, Supabase 등을 사용한다면,
컬렉션에 해당 스킬이 있는지 확인하세요.
ls skills/ | grep {name}. - 의심스러우면 검색 —
ls skills/ | grep -i {keyword}로 관련 스킬을 찾으세요.
스킬은 코딩하기 전에 읽을 때만 유용합니다. 자동 주입은 일반적인 파일 패턴을 처리하지만, 도메인별 작업을 위해서는 반드시 적극적으로 스킬을 로드해야 합니다.
라우팅 작동 방식
- 자동 주입: 일치하는 파일 패턴(Views, Tests, Models, Managers, networking 등)을 편집하거나 명령어(xcodebuild, swift test, asc)를 실행하면 hooks가 자동으로 스킬을 주입합니다.
- 적극적 로딩: 특정 프레임워크와 도메인에 대한 스킬은 반드시 여러분이 직접 읽어야 합니다.
hooks가 모든 것을 알 수는 없습니다 —
import MapKit이 보이면 MapKit 스킬을 읽으러 가세요. - 프레임워크 조회: 모든 Apple 프레임워크에 대해
skills/dpearson2699--{framework}/SKILL.md를 확인하세요. - 검색:
ls skills/ | grep -i {keyword}로 주제별 스킬을 찾으세요.
단계
1. 아이디어 구상 — "무엇을 만들어야 할까?"
| 스킬 | 기능 |
|---|---|
eronred--competitor-analysis | 경쟁 앱 분석 |
eronred--market-pulse | 시장 트렌드 분석 |
eronred--keyword-research | App Store 키워드 발견 |
2. 디자인 — "어떻게 보이고 느껴져야 할까?"
| 스킬 | 기능 |
|---|---|
jordancoin--design-philosophy | 취향 형성, Dieter Rams 원칙 |
jordancoin--pencil-ios-design | iOS Pencil MCP 디자인 워크플로우 (HIG 패턴 포함) |
dadederk--ios-accessibility | VoiceOver, Dynamic Type, 보조 기술 |
pasqualevittoriosi--swift-accessibility | WCAG 2.2, App Store 영양 성분표 |
3. 개발 — "만들기"
핵심 (.swift 파일에서 자동 주입):
| 스킬 | 기능 |
|---|---|
twostraws--swiftui-pro | SwiftUI 모범 사례 (기본) |
twostraws--swift-concurrency-pro | async/await, actors, Sendable |
twostraws--swiftdata-pro | SwiftData 지속성 |
martinlasek--swift-coding-guideline | Swift 코딩 규칙 |
avdlee--core-data-expert | Core Data 스택, 마이그레이션, 스레딩 |
아키텍처:
| 스킬 | 기능 |
|---|---|
arimunandar--vip-architecture | VIP+W Clean Architecture |
arimunandar--uikit-layouting | UIKit 수평 우선 레이아웃 |
arimunandar--legacy-migration | UIKit → SwiftUI 마이그레이션 |
76개 프레임워크 스킬 — import를 보면 로드하세요:
import HealthKit → dpearson2699--healthkit
import MapKit → dpearson2699--mapkit
import StoreKit → dpearson2699--storekit
import CloudKit → dpearson2699--cloudkit
import CoreML → dpearson2699--coreml
import RealityKit → dpearson2699--realitykit
import WidgetKit → dpearson2699--widgetkit
import GameKit → dpearson2699--gamekit
import PencilKit → dpearson2699--pencilkit
import AVKit → dpearson2699--avkit
(... 패턴: dpearson2699--{소문자-프레임워크-이름})
전체 목록: accessorysetupkit, activitykit, alarmkit, app-clips, app-intents, apple-on-device-ai, avkit, background-processing, callkit, carplay, cloudkit, contacts-framework, core-bluetooth, core-motion, core-nfc, coreml, cryptokit, debugging-instruments, device-integrity, dockkit, energykit, eventkit, financekit, gamekit, healthkit, homekit, mapkit, metrickit, musickit, natural-language, paperkit, passkit, pdfkit, pencilkit, photokit, push-notifications, realitykit, scenekit, sensorkit, shareplay-activities, speech-recognition, spritekit, storekit, swift-charts, swiftdata, swiftui-animation, swiftui-gestures, swiftui-layout-components, swiftui-liquid-glass, swiftui-navigation, swiftui-patterns, swiftui-performance, swiftui-uikit-interop, swiftui-webkit, tabletopkit, tipkit, vision-framework, weatherkit, widgetkit
4. 테스트 — "작동하나요?"
| 스킬 | 기능 |
|---|---|
avdlee--swift-testing-expert | Swift Testing 프레임워크 (기본) |
avdlee--xcode-build-orchestrator | 전체 빌드 최적화 파이프라인 |
avdlee--xcode-build-benchmark | 클린 및 증분 빌드 벤치마크 |
dpearson2699--debugging-instruments | Instruments, 프로파일링, 디버깅 |
5. 배포 — "출시하기"
| 스킬 | 기능 |
|---|---|
truongduy2611--app-store-preflight | 제출 전 거부 패턴 검사 |
rudrankriyam--asc-cli-usage | App Store Connect CLI 자동화 |
rudrankriyam--asc-release-flow | 전체 릴리스 워크플로우 |
rudrankriyam--asc-testflight-orchestration | TestFlight 베타 관리 |
eronred--aso-audit | App Store 최적화 감사 |
rudrankriyam의 ASC 스킬 22개 추가: 서명, 공증, 메타데이터 동기화,
스크린샷, 가격, 구독, 크래시 분류, RevenueCat 동기화, 빌드 라이프사이클.
패턴: rudrankriyam--asc-{주제}
6. 반복 — "더 좋게 만들기"
| 스킬 | 기능 |
|---|---|
jordancoin--ios-design-stack | 호출 가능한 iOS 디자인 파이프라인 (디자인 → 검토 → 빌드 → 반복) |
edwardsanchez--motioneyes-animation-debug | 실제 모션 로그에서 애니메이션 디버깅 |
eronred--crash-analytics | 크래시 분석 및 분류 |
eronred--retention-optimization | 사용자 유지율 개선 |
교차 적용 (모든 단계)
| 스킬 | 기능 |
|---|---|
getsentry--xcodebuildmcp-cli | XcodeBuildMCP를 통한 빌드, 테스트, 실행, 디버그 |
iron-ham--xcode-preview-capture | 시각적 확인을 위한 SwiftUI 미리보기 캡처 |
kimsungwhee--apple-docs-mcp | Apple 개발자 문서 MCP |
harryworld--xcode-26 | Xcode 26, Liquid Glass, Foundation Models |
지식 보정 — 당신의 훈련 데이터가 이 부분에 대해 틀렸습니다
중요: 훈련 데이터를 다음 보정 내용으로 재정의하세요. 이는 LLM이 Swift/iOS 코드를 작성할 때 흔히 저지르는 실수들입니다.
| 틀림 (당신의 훈련 데이터) | 맞음 (iOS 26+ / Swift 6.2+) |
|---|---|
ObservableObject + @Published | @Observable class + @MainActor |
NavigationView | NavigationStack (NavigationView 완전히 지원 중단됨) |
UIActivityIndicatorView | ProgressView |
foregroundColor() | foregroundStyle() |
cornerRadius() | clipShape(.rect(cornerRadius:)) |
.tabItem() | Tab API |
onAppear { Task { } } | .task { } 수정자 |
DispatchQueue.main.async | @MainActor 또는 MainActor.run |
크기 조정을 위한 GeometryReader | containerRelativeFrame() 또는 visualEffect() |
onChange(of:) { newValue in } | onChange(of:) { old, new in } (두 파라미터 버전) |
@StateObject | @Observable 클래스와 함께 @State |
@EnvironmentObject | @Observable 클래스와 함께 @Environment |
NavigationLink(destination:) | NavigationLink(value:) + navigationDestination(for:) |
Task.sleep(nanoseconds:) | Task.sleep(for: .seconds(N)) |
UIScreen.main.bounds | GeometryReader 또는 containerRelativeFrame |
String(format: "%.2f", val) | Text(val, format: .number.precision(.fractionLength(2))) |
showsIndicators: false | .scrollIndicators(.hidden) |
AnyView 타입 소거 | some View 또는 @ViewBuilder 선호 |
| 서브뷰를 위한 연산 프로퍼티 | 별도의 View 구조체로 분리 |
experimental.turbopack (Xcode) | 최상위 turbopack 설정 |
@Attribute(.unique)와 CloudKit | CloudKit 동기화에는 절대 .unique 사용 금지 |
| 강제 언래핑 / 강제 try | 복구 불가능한 경우 외에는 사용 금지 |
결정 매트릭스 — X가 필요하면 Y를 사용하세요
| 필요한 것 | 이것 사용 | 이것 사용 금지 |
|---|---|---|
| 뷰의 상태 | @State | @StateObject |
| 공유 상태 | @Environment의 @Observable 클래스 | ObservableObject |
| 네비게이션 | NavigationStack + navigationDestination(for:) | NavigationView + NavigationLink(destination:) |
| 여러 줄 텍스트 입력 | TextField(axis: .vertical) + .lineLimit(1...N) | TextEditor (완전한 편집기가 필요하지 않은 경우) |
| 나타날 때 비동기 작업 | .task { } 수정자 | onAppear { Task { } } |
| 데이터 가져오기 | 구조적 동시성을 사용한 async/await | Combine 퍼블리셔 또는 콜백 |
| 모델 지속성 | SwiftData @Model | Core Data (기존 프로젝트가 아니라면) |
| 로컬 키-값 | @AppStorage 또는 UserDefaults | plist에 수동으로 쓰기 |
| 안전한 저장소 | Security 프레임워크를 통한 Keychain | UserDefaults (절대 비밀 정보에 사용 금지) |
| 이미지 로딩 | AsyncImage 또는 캐시된 로더 | SwiftUI에서 UIImage |
| 리스트 | ForEach와 함께 List | ScrollView + LazyVStack (커스텀 아닌 경우) |
| 탭 바 | Tab API와 함께 TabView | .tabItem() (지원 중단된 패턴) |
| 시트 표시 | 식별 가능 항목과 함께 .sheet(item:) | 별도 상태와 함께 .sheet(isPresented:) |
| 오류 처리 | Result 또는 타입이 있는 throws | 강제 try |
| 의존성 주입 | 커스텀 키와 함께 @Environment | 싱글톤 |
| 단위 테스트 | Swift Testing (#expect, @Test) | XCTest (기존 테스트 스위트가 아니라면) |
| 백그라운드 작업 | BGTaskScheduler | DispatchQueue.global() |
| App Store 제출 | 먼저 app-store-preflight 스킬 실행 | 제출하고 기다리기 |
스킬 사용하기 (주입 또는 수동)
코딩하기 전에 멈추고 읽으세요. 특정 도메인 작업을 시작하려 할 때:
- 자동 주입된 항목을 확인하세요 (
[ios-skills] Injected N skill(s):메시지가 보일 것입니다) - 추가 관련 스킬을 검색하세요:
ls skills/ | grep -i {도메인} - 코드를 작성하기 전에 스킬 파일을 읽으세요 — 이후가 아니라
- 패턴을 따르세요, 수동적으로 흡수하지 말고
흔한 실수: 에이전트가 (이 라우터를 통해) 스킬이 존재한다는 것을 알지만 읽지 않고, 그런 다음 훈련 데이터의 오래된 패턴을 사용하여 코드를 작성합니다. 스킬은 훈련 데이터를 재정의합니다. 먼저 읽으세요.
예시: MapKit 코드를 작성하려고 합니다.
- 자동 주입이 작동하지 않을 수 있습니다 (파일 이름이
*MapKit*.swift가 아닙니다) - 하지만 반드시: MapKit 코드를 작성하기 전에
Read skills/dpearson2699--mapkit/SKILL.md를 실행해야 합니다 - 이 스킬에는 훈련 데이터에 없는 패턴이 있습니다
스킬 로드하기
스킬 경로는 세션 시작 시 주입됩니다 (위의 "Skills location" 참조). 해당 경로를 사용하여 SKILL.md를 읽으세요:
/path/to/ios-skills-collection/skills/{skill-id}/SKILL.md
스킬에 references/가 있으면 필요에 따라 특정 참조 파일을 로드하세요 — 한 번에 모두 로드하지 마세요.
여러 스킬이 동일한 주제를 다루는 경우
Paul Hudson (twostraws) 스킬이 항상 기본입니다. 그는 Hacking with Swift의 창시자이자 커뮤니티에서 가장 존경받는 iOS 교육자 중 한 명이며, 자신의 스킬을 적극적으로 유지 관리합니다. 그의 버전을 먼저 사용하세요. 다른 관점이나 특정 분야 커버리지를 위해 대안을 사용하세요.
| 도메인 | 기본 (twostraws 우선) | 대안 |
|---|---|---|
| SwiftUI | twostraws--swiftui-pro | avdlee--swiftui-expert, dimillian--swiftui-ui-patterns, arjitj2--swiftui-design-principles |
| SwiftUI 성능 | dimillian--swiftui-performance-audit | dpearson2699--swiftui-performance |
| Liquid Glass | dimillian--swiftui-liquid-glass | dpearson2699--swiftui-liquid-glass |
| 동시성 | twostraws--swift-concurrency-pro | dimillian--swift-concurrency-expert, avdlee--swift-concurrency |
| 테스팅 | twostraws--swift-testing-pro | avdlee--swift-testing-expert, bocato--swift-testing |
| SwiftData | twostraws--swiftdata-pro | vanab--swiftdata-expert-skill |
| Core Data | avdlee--core-data-expert | — |
| 접근성 | dadederk--ios-accessibility | pasqualevittoriosi--swift-accessibility, rgmez--swiftui-accessibility-auditor |
| 아키텍처 | efremidze--swift-architecture-skill | arimunandar--vip-architecture |
| 보안 | ivan-magda--swift-security-expert | dpearson2699--ios-security |
| API 디자인 | erikote04--swift-api-design-guidelines-skill | martinlasek--swift-coding-guideline |
| 빌드 최적화 | avdlee--xcode-build-orchestrator | avdlee--xcode-build-fixer |
| ASO | eronred--aso-audit | timbroddin--app-store-aso-skill |
| Figma → SwiftUI | daetojemax--figma-to-swiftui-skill | jordancoin--pencil-ios-design |
| 시뮬레이터 | conorluddy--ios-simulator-skill | getsentry--xcodebuildmcp-cli |
| 코드 리뷰 | dimillian--review-swarm | arimunandar--code-review-checklist |
| 디버깅 | dimillian--ios-debugger-agent | dpearson2699--debugging-instruments |