القائمة
iOS 17+ SwiftUI patterns를 구현할 때 사용합니다: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver), 비동기 작업(.task/.refreshable), 또는 ObservableObject/@StateObject에서 마이그레이션하는 경우.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
TCA(The Composable Architecture)로 Feature를 구축하거나 reducer 구조화, state 관리, effect·navigation 처리, TCA feature 테스트를 할 때 사용합니다. @Reducer, Store, Effect, TestStore, reducer 조합 패턴을 다룹니다.
구현한 화면의 스크린샷·UI hierarchy를 Zeplin 시안 스펙과 항목별로 대조해 PASS/DIFF를 보고합니다.
SwiftUI 코드를 리뷰·정리하거나 soft-deprecated API를 점검할 때 사용합니다. view 구조 분리, dataflow/environment 검토, ForEach identity, localization, deprecation 마이그레이션을 다룹니다. (신규 구현 패턴은 swiftui-patterns 스킬 사용)
device 또는 simulator에서 스크린샷, UI hierarchy, 터치 interaction을 통해 iOS 앱 동작을 확인합니다.
async/await 코드를 작성하거나, strict concurrency를 활성화하거나, Sendable 오류를 수정하거나, completion handler로부터 마이그레이션하거나, actor로 공유 상태를 관리하거나, 동시성을 위해 Task/TaskGroup을 사용할 때 사용합니다.
NavigationStack 문제(응답 없음, 예기치 않은 pop, 크래시), build 실패(SPM resolution, "No such module", build가 멈추는 경우), 또는 메모리 문제(retain cycle, leak, deinit이 호출되지 않는 경우)를 디버깅할 때 사용합니다. iOS/macOS를 위한 체계적인 진단 워크플로우입니다.
| name | swiftui-patterns |
| description | iOS 17+ SwiftUI patterns를 구현할 때 사용합니다: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver), 비동기 작업(.task/.refreshable), 또는 ObservableObject/@StateObject에서 마이그레이션하는 경우. |
SwiftUI 17+는 @Observable로 ObservableObject 보일러플레이트 코드를 제거하고, @Environment로 environment 주입을 단순화하며, task 기반 async patterns를 도입합니다. 핵심 원칙은 리액티브 라이브러리 대신 Apple의 최신 API를 사용하는 것입니다.
| 필요 | 사용 (iOS 17+) | 사용 금지 |
|---|---|---|
| Observable 모델 | @Observable | ObservableObject |
| Published 속성 | 일반 속성 | @Published |
| 자체 상태 | @State | @StateObject |
| 전달된 모델 (바인딩) | @Bindable | @ObservedObject |
| Environment 주입 | environment(_:) | environmentObject(_:) |
| Environment 접근 | @Environment(Type.self) | @EnvironmentObject |
| 화면 표시 시 비동기 실행 | .task { } | .onAppear { Task {} } |
| 값 변경 | onChange(of:initial:_:) | onChange(of:perform:) |
@Observable을 사용합니다 (@Published 불필요)@State를, 전달되는 모델에는 @Bindable을 사용합니다.task { }를 사용합니다 (사라질 때 자동으로 취소됨)NavigationPath와 함께 NavigationStack을 사용합니다.accessibilityLabel()과 .accessibilityHint()를 적용합니다콘텐츠가 필요할 가능성이 조금이라도 있다면 항상 참조 파일을 로드하세요. pattern을 놓치거나 실수를 하는 것보다 context를 확보하는 것이 더 낫습니다.
| 참조 | 로드 시기 |
|---|---|
| Observable | 새로운 @Observable 모델 클래스를 생성할 때 |
| State 관리 | @State, @Bindable, @Environment 중에서 선택할 때 |
| Environment | View 계층 구조에 의존성을 주입할 때 |
| View Modifiers | onChange, task, 또는 iOS 17+ modifier를 사용할 때 |
| 마이그레이션 가이드 | iOS 16 코드를 iOS 17+로 업데이트할 때 |
| MVVM Observable | view model architecture를 설정할 때 |
| 내비게이션 | 프로그래밍 방식 또는 딥링크 내비게이션 |
| 성능 | 항목이 100개 이상인 List 또는 과도한 리렌더링 |
| UIKit Interop | UIKit 컴포넌트(WKWebView, PHPicker)를 래핑할 때 |
| Accessibility | VoiceOver, accessibility 액션 |
| Async Patterns | 로딩 상태, 새로고침, 백그라운드 task |
| Composition | 재사용 가능한 view modifier 또는 복잡한 조건부 UI |
전달된 모델에 @Bindable을 과도하게 사용 — 모든 속성마다 @Bindable을 생성하면 불필요하게 View가 다시 로드됩니다. @Bindable은 양방향 바인딩이 필요한 변경 가능한 모델 속성에만 사용하세요. 읽기 전용 계산 속성은 일반 속성을 사용해야 합니다.
상태 배치 오류 — 전용 @Observable 모델 대신 View에 모델 상태를 두면 View 로직이 뒤엉키게 됩니다. 항상 모델과 View의 관심사를 분리하세요.
NavigationPath 상태 손상 — NavigationPath를 잘못 변경하면 일관되지 않은 상태로 남을 수 있습니다. 경로 손상을 피하려면 적절한 상태 관리와 함께 navigationDestination(for:destination:)을 사용하세요.
.task 취소 누락 — .task는 사라질 때 자동으로 취소를 처리하지만, 중첩된 Task는 그렇지 않습니다. 복잡한 async 흐름에서는 zombie task를 피하기 위해 명시적인 취소 추적이 필요합니다.
environment invalidation 무시 — 부모에서 environment 값을 변경해도 자식 View가 자동으로 무효화되지는 않습니다. @Environment를 일관되게 사용하고, observation을 기반으로 리렌더링이 언제 발생하는지 이해하세요.
UIKit interop 메모리 누수 — delegate cycle이 끊어지지 않으면 UIViewRepresentable과 UIViewControllerRepresentable이 누수될 수 있습니다. weak reference와 명시적인 정리가 필요합니다.