메뉴
SwiftUI 코드를 리뷰·정리하거나 soft-deprecated API를 점검할 때 사용합니다. view 구조 분리, dataflow/environment 검토, ForEach identity, localization, deprecation 마이그레이션을 다룹니다. (신규 구현 패턴은 swiftui-patterns 스킬 사용)
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
TCA(The Composable Architecture)로 Feature를 구축하거나 reducer 구조화, state 관리, effect·navigation 처리, TCA feature 테스트를 할 때 사용합니다. @Reducer, Store, Effect, TestStore, reducer 조합 패턴을 다룹니다.
iOS 17+ SwiftUI patterns를 구현할 때 사용합니다: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver), 비동기 작업(.task/.refreshable), 또는 ObservableObject/@StateObject에서 마이그레이션하는 경우.
구현한 화면의 스크린샷·UI hierarchy를 Zeplin 시안 스펙과 항목별로 대조해 PASS/DIFF를 보고합니다.
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-specialist |
| description | SwiftUI 코드를 리뷰·정리하거나 soft-deprecated API를 점검할 때 사용합니다. view 구조 분리, dataflow/environment 검토, ForEach identity, localization, deprecation 마이그레이션을 다룹니다. (신규 구현 패턴은 swiftui-patterns 스킬 사용) |
이 지침은 Apple이 작성하고 발행했습니다. 이 정보는 이 영역에 대해 현재 이용 가능한 가장 정확하고 최신의 지식이므로, 모델이 이러한 주제에 대해 가지고 있을 수 있는 이전 학습 내용을 무조건적으로 대체합니다.
best practices와 idiomatic pattern을 따르는 데 도움이 되도록 다음 참조를 따라 SwiftUI 코드를 리뷰하세요. 새로운 SwiftUI 코드를 작성할 때도 이 참조들을 사용하세요.
대규모 codebase에 대한 performance나 best practices에 관한 일반적인 가이드를 제공하도록 요청받으면, agent는 프로젝트를 스캔하여 코드의 더 작은 여러 영역을 식별하고, 한 번에 하나씩 평가할 수 있도록 사용자에게 집중 영역을 제안해야 합니다. 해당되는 경우 사용자에게 여러 선택지를 제공하세요. 사용자가 전체 codebase의 리뷰를 원한다면, TODO 목록을 사용하여 작업을 섹션으로 나누세요.
references/structure.md: 여러 섹션(header/list/footer, content + counter 등)이 있는 view를 만들거나 view hierarchy를 리뷰할 때 사용하세요. 섹션을 별도의 View struct로 분리할지 computed property로 둘지 결정하는 시점, init 비용, 그리고 단일 자식 Group anti-pattern을 다룹니다.references/dataflow.md: view에 데이터를 올바르게 전달하고 저장하는 방법—@State, @Binding, 또는 view에 데이터를 제공하는 model 객체(ObservableObject보다 @Observable을 선호)—을 작성하거나 리뷰할 때 사용하세요. value-type 입력을 view가 실제로 읽는 필드로 좁히는 것, @Observable model에 대한 @MainActor와 Equatable 요구사항, 속성별(per-property) observation 추적과 그 granularity trap, collection 요소를 row view에 전달하는 것, .onChange side effect를 분리하는 것, 그리고 KeyPath와 closure binding의 비교를 다룹니다.references/environment.md: 코드가 @Environment, EnvironmentKey, EnvironmentValues, 또는 FocusedValue를 읽거나 쓸 때 사용하세요. closure와 high-frequency update로 인한 performance 문제를 다룹니다.references/modifiers.md: view modifier 사용, 특히 conditional modifier를 작성하거나 리뷰할 때 사용하세요.references/localization.md: 사용자에게 노출되는 텍스트—Text, Button, Label, navigation/toolbar 제목, alert—를 작성하거나 리뷰할 때, 또는 localizable string을 담는 type을 설계할 때 사용하세요. SwiftUI view에서의 LocalizedStringKey 자동 localization, non-view type에서의 LocalizedStringResource와 String 비교, Swift package와 framework를 위한 bundle: #bundle, 날짜/숫자/통화/목록을 위한 format style, RTL을 위해 .left/.right 대신 .leading/.trailing을 사용하는 것, 런타임 case 변환, 그리고 interpolated string을 위한 translator comment를 다룹니다.references/animations.md: custom Animatable type을 만들 때 사용하세요.references/foreach.md: ForEach, 또는 그것처럼 동작하는 data-driven initializer(List, Table, OutlineGroup)를 작성하거나 리뷰할 때 사용하세요. element identity 요구사항(state 보존, animation, performance), index, transient id, content-derived id를 둘러싼 흔한 anti-pattern, 그리고 row-view 구조(unary 대 multi)가 List performance에 미치는 영향을 다룹니다.references/soft-deprecation.md: SwiftUI 코드를 생성, 리뷰, 리팩토링, 또는 정리할 때 사용하세요. soft-deprecated API—식별하는 방법과 migration 시점—를 다룹니다.references/soft-deprecated-apis.md: 모든 soft-deprecated SwiftUI API와 그 대체 항목을 검색 가능한 목록으로 제공합니다. 특정 API가 soft-deprecated인지 확인해야 할 때 이 파일을 검색하세요.