Communitygithub.com

CharbelElBateh/personal-website

최신 Swift를 올바르게 작성하는 방법 — 값 타입 모델링, Swift 6 데이터 레이스 안전성과 접근 가능한 동시성(@concurrent, MainActor 기본, Actor, 태스크 그룹), 프로토콜과 제네릭(some vs any), API 설계, 성능 및 ARC, Swift Testing, 매크로, 그리고 에이전트가 아직 모르는 현대적인 언어 기능을 다룹니다. Swift 코드를 작성, 검토, 마이그레이션하거나 동시성 오류, 행(hang), 데이터 레이스, 순환 참조, 성능 문제를 수정할 때 사용하세요.

personal-website란 무엇인가요?

이 스킬은 Swift 6.4까지의 최신 Swift 언어 기능을 활용하여 올바르고 안전하며 효율적인 코드를 작성하는 방법을 제공합니다. Swift 에이전트(Claude Code, Cursor, Codex 등)가 Swift 코드를 작성하거나 검토할 때, 특히 동시성, 데이터 레이스, 성능 문제를 해결할 때 참고할 수 있는 현대적인 Swift 모범 사례를 명확하게 제시합니다. 주요 내용으로는 값 타입(struct/enum) 기본 사용, Swift 6.2 동시성 모델(@concurrent, MainActor 기본 분리, actor 재진입), Sendable 프로토콜을 통한 데이터 공유, 구조적 동시성(async let, 태스크 그룹), 프로토콜과 제네릭(some vs any), 오류 처리 및 옵셔널, 성능 최적화(ARC, COW), Swift Testing, 매크로 등이 포함되어 있습니다. 이 스킬은 '점진적 공개(progressive-disclosure)' 원칙에 따라 가장 단순하고 정적인 접근부터 시작하여 필요할 때만 동적 기능(동시성, 참조 의미론, 존재 타입)을 추가하는 Swift 고유의 설계 철학을 강조합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CharbelElBateh/personal-website/tree/HEAD/.claude/skills/write-swift

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Swift 작성하기

초기 응답

이 스킬이 특정 질문 없이 처음 호출되면, 다음만 응답하세요:

현대적인 Swift를, 언어가 의도한 방식으로 작성할 수 있도록 도와드릴 준비가 되었습니다.

사용자가 질문하기 전까지 다른 정보는 제공하지 마세요.

Swift 6.4까지의 최신 Swift를 언어가 의도한 방식으로 작성하는 방법입니다.

도구 체인 기준: Swift 6.3 (2026년 8월 기준 최신 릴리스). 여기 있는 모든 내용은 6.3에서 컴파일되며, ⚠ 표시가 있는 것은 아직 릴리스되지 않은 Swift 6.4 기능입니다. 동시성 지침은 Swift 6.2 모델을 기준으로 합니다. 프로젝트가 6.1 이하인 경우, §3의 async 및 @concurrent 관련 규칙은 적용되지 않습니다.

핵심 원칙: Swift는 점진적 공개 언어입니다. 가장 단순하고, 가장 정적이며, 가장 단일 스레드로 동작하는 것부터 시작하고, 이유를 명확히 설명할 수 있을 때만 동적 기능(동시성, 참조 의미론, 존재 타입, 안전하지 않은 포인터)을 구매하세요. 아래의 모든 규칙은 이 원칙을 적용한 것입니다.

이러한 기본값의 계층 구조를 모델링하세요. 이유를 명확히 설명할 수 있을 때만 한 단계 아래로 내려가세요:

필요 사항기본 선택다음 경우에만 아래로 이동
데이터struct / enum식별성, 공유, 상속이 필요할 때
추상화구체 타입타입 전체에 반복되는 코드가 있을 때
다형성some P (제네릭)이기종 저장이 필요할 때 → any P
실행Main Actor, 동기프로파일링에서 행(hang)이 나타날 때 → async → @concurrent → actor
메모리Array, String프로파일링에서 비용이 확인될 때 → InlineArray, Span
안전성안전한 APIC 상호 운용 또는 측정된 핫 경로일 때 → Unsafe*

1. 값 타입으로 데이터 모델링

값 타입은 Swift에서 특별한 경우가 아니라 기본값입니다.

  • 기본적으로 struct와 enum을 사용하세요. class는 식별성, 공유 가변 상태, 상속, 또는 리소스 수명에만 사용하세요. 윈도우, 데이터베이스 연결, 렌더링 엔진에 저장된 엔티티는 식별성을 가집니다. Point, Drink, Material은 그렇지 않습니다.
  • 기본적으로 let을 사용하고, 변경할 때만 var를 사용하세요. 이는 any보다 some을, 참조보다 값을 먼저 사용하는 규율과 같습니다: 좁게 시작하고, 이유가 있을 때만 넓히세요.
  • 가변 참조 타입 프로퍼티를 가진 구조체는 값도 아니고 참조도 아닙니다. 복사본이 객체를 공유하며, 변경 사항이 복사본 간에 누출됩니다. 참조된 타입을 불변으로 유지하거나, 해당 타입으로 전달하는 계산된 프로퍼티만 노출하거나, 복사-시-쓰기 뒤에 private 저장 프로퍼티로 만드세요.
  • 복사-시-쓰기는 대역 외 저장과 값 의미론을 함께 얻는 방법입니다. 구조체에서 final 클래스를 래핑하고 변경 전에 isKnownUniquelyReferenced(&storage)를 확인하세요. 고유하지 않으면 먼저 복사합니다. 이것이 정확히 Array, String, Dictionary가 작동하는 방식입니다.
  • 열거형은 "고정된 것들의 집합"과 상호 배타적인 상태를 위한 도구입니다. 여러 개의 옵셔널 저장 프로퍼티(isSharing, selectedRows, shareTarget)를 하나의 enum State로 대체하면 유효하지 않은 조합을 표현 불가능하게 만들고, 상태 변경을 잊어버릴 수 있는 일련의 프로퍼티 쓰기가 아닌 원자적 작업으로 만듭니다.
  • 값을 구성하면 값이 생성됩니다. 저장 프로퍼티가 모두 값 타입인 구조체는 값 의미론을 자동으로 가지며, 이는 실행 취소, diff, 상태 복원을 프로퍼티별 코드 경로가 아닌 단일 코드 경로로 만듭니다.
struct Material {                       // 값 의미론 유지
  var roughness: Double
  private var _texture: Texture         // 클래스

  var color: Color {
    get { _texture.color }
    set {
      if !isKnownUniquelyReferenced(&_texture) { _texture = Texture(copying: _texture) }
      _texture.color = newValue
    }
  }
}

비복사 타입(~Copyable)은 고유 소유권을 표현합니다: 파일 디스크립터, 은행 송금, 열린 리소스. 복사를 억제하면 "이것을 두 번 실행하지 마라"는 단언(assertion)에서 컴파일 오류가 되고, 구조체에서 deinit이 의미를 갖게 됩니다. 완료 메서드를 consuming으로 표시하여 컴파일러가 마지막 사용임을 증명하도록 하세요. 매개변수 소유권이 명시적이 됩니다: borrowing(읽기 전용, 기본값), consuming(가져감), inout/mutating(임시 쓰기 접근).


2. 오류와 옵셔널 — 실패 경로를 보이게 만드세요

Swift 오류 처리는 세 가지에 기반합니다: 오류의 원인이 표시되어 놀라게 하지 않으며, 오류는 조치를 취할 수 있는 충분한 컨텍스트를 전달하며, 복구 가능한 오류는 프로그래머 실수와 다릅니다.

  • 복구 가능 → throw. 프로그래머 실수 → precondition/fatalError. 실패한 네트워크 호출은 프로그램을 계속 실행합니다. 범위를 벗어난 인덱스는 코드가 잘못되었으며 버그가 보안 문제가 되기 전에 중단되어야 함을 의미합니다.
  • 연관 값을 가진 열거형이 최상의 오류 타입입니다. case duplicateFriend(String)이 case duplicateFriend보다 낫습니다. 컨텍스트가 핵심입니다.
  • 오류 조건에는 guard를 사용하세요. 종료 경로를 강제하기 때문입니다. 일반적인 언래핑에는 if let을 사용하세요.
  • 타입이 있는 throws(throws(MyError))는 내부 함수, 오류 전달 제네릭 코드, 제약된 환경을 위한 것입니다. any Error 박싱 비용이 너무 클 때 사용하세요. 공개 API의 경우, 타입이 없는 throws는 나중에 오류 타입을 변경할 자유를 보존합니다. 통일성 참고: throws는 throws(any Error)이고, 던지지 않는 것은 throws(Never)입니다. 이것이 map이 둘 다 추상화할 수 있게 하는 이유입니다.
  • 강제 언래핑은 불변 조건을 명시할 수 있는 경우에만 사용하고, 단순한 !보다 메시지가 있는 #require/precondition을 선호하세요.

3. 동시성: 프로파일링이 말하기 전까지 단일 스레드 유지

이 부분은 에이전트가 가장 자주 틀리는 섹션입니다. Swift 6.2에서 모델이 변경되었기 때문입니다.

모든 앱을 완전히 메인 스레드에서 시작하세요. 단일 스레드 코드는 많은 부분을 처리할 수 있으며, 대부분의 앱은 절대 단일 스레드를 벗어날 필요가 없습니다.

순서대로 진행하세요. 단계를 건너뛰지 마세요.

  1. Main Actor에서 단일 스레드. 동시성 전혀 없음. 대부분의 앱에 충분합니다.
  2. async/await 대기 시간(네트워크, 디스크)을 숨기기 위해. 여전히 자체 동시성은 없습니다. URLSession.data(from:)과 같은 SDK API가 대신 오프로드합니다.
  3. @concurrent 자신의 비용이 많이 드는 작업을 메인 스레드에서 이동 — Instruments가 행(hang)을 보여준 후에만.
  4. actor _상태_를 Main Actor에서 이동 — 너무 많은 Main Actor 상태가 작업을 계속 다시 이동하도록 강제할 때만.

먼저 올바른 빌드 설정을 켜세요. 모든 프로젝트에서 접근 가능한 동시성(Approachable Concurrency) 을 활성화하세요. 앱 모듈 및 UI 관련 모듈의 경우 기본 Actor 격리(Default Actor Isolation) 를 MainActor로 설정하세요. Xcode 26의 새 앱 프로젝트에서는 기본값이며, 대부분의 @MainActor 어노테이션을 없앱니다. 패키지에서는: swiftSettings: [.defaultIsolation(MainActor.self)]. 범용 라이브러리에는 MainActor 기본을 설정하지 마세요. 라이브러리는 nonisolated API를 제공하고 클라이언트가 작업을 실행할 위치를 결정하도록 해야 합니다.

변경된 규칙

Swift 6.2에서 함수를 async로 표시해도 현재 Actor에서 이동하지 않습니다. 호출된 곳에서 실행됩니다. 이것이 "가장 자연스러운 코드를 작성하는 것"이 기본적으로 데이터 레이스로부터 자유롭게 만드는 이유입니다.

  • @concurrent — 항상 동시 스레드 풀로 전환합니다. 자신의 CPU 집약적 작업에 사용하세요.
  • nonisolated — 호출된 곳에서 실행됩니다. 라이브러리 API의 올바른 기본값입니다. 호출자가 결정하기 때문입니다. 타입에 nonisolated를 사용하면 모든 멤버가 nonisolated가 됩니다(Swift 6.1+).
  • 둘 다 아님 — 호출자의 Actor에 남습니다.
nonisolated struct PhotoProcessor {          // Main Actor로부터 분리
  @concurrent                                // 백그라운드에서 실행됨이 보장됨
  func process(_ data: Data) async -> ProcessedPhoto {
    async let sticker = extractSticker(data)  // 두 개의 독립적인 작업, 병렬로
    async let colors  = extractColors(data)
    return await ProcessedPhoto(sticker: sticker, colors: colors)
  }
}
  • 오프로드하기 전에 프로파일링하세요. Instruments(Time Profiler, hangs)를 사용하세요. 동시성 없이 코드를 더 빠르게 만들 수 있다면 항상 먼저 그렇게 하세요. 동시성에는 실제 비용이 있습니다 — 작업 할당, 스케줄링, 추론.
  • 사소한 작업을 위해 태스크를 생성하지 마세요. UserDefaults 값을 읽기 위한 하위 태스크는 절약하는 것보다 더 많은 비용이 듭니다.
  • 종단 간 작업당 하나의 태스크. 순서대로 발생해야 하는 작업은 하나의 태스크에 넣고, 독립적인 작업은 별도의 태스크로 만들어 런타임이 인터리브할 수 있게 하세요.
  • await는 중단 지점이며, 원자성을 깨뜨립니다. 중단된 동안 상태가 변경될 수 있으며, 다른 스레드에서 재개될 수 있습니다. 모든 await 후에 가정을 다시 확인하세요. await를 가로질러 락을 보유하지 마세요. await를 가로질러 스레드 로컬 저장소에 의존하지 마세요.

Actor 재진입

Actor는 상호 배제를 보장하지만 트랜잭션은 보장하지 않습니다. 동일한 Actor의 두 await 사이에 다른 작업이 실행됩니다.

  • 동기 메서드에서 Actor 상태를 변경하세요. Actor의 동기 코드는 중단 없이 완료될 때까지 실행됩니다. 이것이 트랜잭션 경계입니다.
  • async Actor 메서드를 얇게 유지하고, 동기 트랜잭션 작업으로 구성하며, 모든 await에서 Actor를 일관된 상태로 남겨두세요.
  • 고전적인 버그: 캐시 확인 → await 다운로드 → 캐시 쓰기. 두 작업 모두 캐시 미스, 둘 다 다운로드, 두 번째가 첫 번째를 덮어씁니다. await 후에 다시 확인하거나, 진행 중인 작업을 중복 제거하세요.
  • Actor는 FIFO가 아닙니다. 우선 순위 역전을 방지하기 위해 가장 높은 우선 순위 작업을 먼저 실행합니다. 순서가 필요하다면 태스크(처음부터 끝까지 실행됨) 또는 AsyncStream을 사용하고, Actor는 사용하지 마세요.

4. Sendable 및 데이터 공유

Sendable은 격리 도메인 간에 공유해도 안전한 타입을 표시합니다. 컴파일러는 모든 태스크 및 Actor 경계에서 이를 확인합니다.

  • 값 타입은 저장소가 Sendable할 때 Sendable합니다 — 공개되지 않은 타입은 자동으로 추론됩니다. 공개 타입은 절대 sendability가 추론되지 않습니다. 공개 타입을 Sendable로 표시하는 것은 클라이언트에 대한 약속이므로, Swift가 이를 직접 작성하도록 요구합니다.
  • Actor와 @MainActor 클래스는 암시적으로 Sendable합니다. 상태가 격리되어 있기 때문입니다.
  • 대부분의 모델 클래스는 @MainActor도 Sendable도 아니어야 합니다. 의도적으로 non-Sendable로 유지하세요. 모델의 절반이 메인 스레드에서 변경되고 나머지 절반이 백그라운드에서 변경되는 것을 방지합니다. Main Actor를 벗어나야 한다면 Sendable이 아닌 nonisolated로 만드세요.
  • 발신자가 사용을 중단하는 한 non-Sendable 객체를 도메인 간에 보낼 수 있습니다. 모든 변경을 전달하기 전에 수행하세요. 이후에 만지는 것이 오류입니다.
  • 클로저도 상태를 캡처합니다. 함수 타입이 실제로 도메인을 가로지르는 경우에만 @Sendable로 표시하세요.
  • @unchecked Sendable은 컴파일러가 확인할 수 없는 약속입니다. 실제 내부 동기화(Mutex, 락)가 있는 타입을 위해 남겨두세요. 전역 변수에 nonisolated(unsafe)를 사용하는 것도 마찬가지입니다 — 최후의 수단이지 경고 음소거기가 아닙니다.

데이터 레이스 오류가 발생하면 이 목록을 따라 작업하세요:

  1. 공유하지 마세요. 공유 객체를 로컬로 이동하여 각 동시 작업이 자체 인스턴스를 가지게 하세요. (이것이 실제 오류의 압도적 다수를 해결하는 방법입니다.)
  2. Sendable 값 타입으로 만드세요. "공유"가 실제로는 복사가 되도록.
  3. Actor로 격리하세요. Main Actor 또는 자체 Actor.
  4. 그런 다음에만 Synchronization 모듈의 Mutex/Atomic(이것들을 let 프로퍼티에 저장) 또는 @unchecked Sendable에 손을 대세요.

전역 및 정적 변수는 가장 일반적인 오류 원인입니다. 선호도 순서: let으로 만드세요. @MainActor에 넣으세요. Mutex로 감싸세요. nonisolated(unsafe). Swift의 전역 변수는 C와 달리 지연 및 원자적으로 초기화됩니다.

이전 콜백 API 연결: 소유한 경우 델리게이트 프로토콜에 @MainActor를 어노테이션하세요. 그렇지 않으면 메서드를 nonisolated로 표시하고 MainActor.assumeIsolated { }를 사용하세요. 이는 건너뛰는 대신 단언하며, 조용히 경쟁하는 대신 큰 소리로 트랩합니다. 적합성에 @preconcurrency를 사용하는 것은 같은 것의 줄임말입니다. @preconcurrency import를 사용하여 마이그레이션되지 않은 모듈의 sendability 경고를 일시적으로 침묵시키세요. 경고는 해당 모듈이 마이그레이션되면 올바르게 다시 나타납니다.


5. 구조적 동시성

항상 구조적 태스크를 선호하세요.

구조적 태스크(async let, 태스크 그룹)는 지역 변수처럼 범위가 지정됩니다: 블록보다 오래 지속될 수 없고, 자동으로 대기되며, 취소, 우선 순위, 태스크 로컬 값을 태스크 트리를 통해 상속합니다. 비구조적 태스크(Task { }, Task.detached)는 이러한 것들을 자동으로 제공하지 않습니다.

  • async let 고정되고 정적으로 알려진 수의 동시 하위 작업에 사용.
  • withTaskGroup 수가 동적일 때 사용. 태스크 그룹은 AsyncSequence를 준수합니다 — 결과가 도착하면 반복하세요. 하위 작업이 아무것도 반환하지 않을 때는 **withDiscardingTaskGroup**을 사용하세요. 각 하위 작업의 리소스를 즉시 해제하고 첫 번째 오류 시 형제 작업을 취소합니다.
  • Task { } 작업의 수명이 범위에 맞지 않을 때만 사용 — 델리게이트 콜백, 버튼 탭, 뷰 표시에 반응할 때. Actor 격리와 우선 순위를 상속하며, 취소를 직접 관리해야 합니다.
  • **Task.detached**는 거의 사용하지 마세요. 아무것도 상속하지 않습니다 — 격리, 우선 순위, 태스크 로컬 값. 분리된 루트가 필요하다면 반복적으로 분리하는 대신 내부에 태스크 그룹을 넣으세요.

취소는 협력적입니다. 취소는 플래그를 설정합니다. 아무것도 중단하지 않습니다. 비용이 많이 드는 작업을 시작하기 전에 Task.isCancelled 또는 try Task.checkCancellation()을 확인하세요. 동기 헬퍼에서도 마찬가지입니다. 실행 중이 아니라 일시 중단된 작업(AsyncSequence의 next())의 경우 withTaskCancellationHandler를 사용하세요. 핸들러는 본문과 동시에 즉시 실행되므로, 핸들러가 접촉하는 상태는 실제 동기화(원자적 또는 락, Actor는 아님 — Actor에서 순서를 보장할 수 없음)가 필요합니다.

동시성을 제한하세요. 항목당 하나의 하위 작업을 무제한 목록에 펼치지 마세요. N개의 하위 작업을 시작한 다음, 나머지를 추가하세요.


6. 프로토콜과 제네릭 — some vs any

some과 any는 같은 것을 말하지 않습니다.

  • some P — 구체적이지만 불투명합니다. 컴파일러는 단 하나의 구체 타입을 봅니다(호출당). 함수 본문을 특수화할 수 있고, 레이아웃을 알고 있으며, 메서드에 정적으로 디스패치할 수 있습니다. 반환 타입이 some P인 함수가 그렇습니다.

  • any P — 상자에 넣습니다. 타입 지우기. 모든 P 값을 저장할 수 있습니다. any P 값이 존재 타입 상자에 들어가며, 각 메서드 호출은 동적 디스패치를 사용합니다. any P는 some과 달리 이기종 컬렉션([any Hashable])과 여러 구체 타입이 필요한 저장소(AnyView, any ShapeStyle)를 가능하게 합니다.

  • 기본적으로 some을 사용하고, 이기종 컬렉션, 저장소, 또는 서로 다른 구체 타입이 반환값을 변경할 때만 any를 사용하세요.

  • **함수 매개변수에서 any P는 프로토콜 타입 매개변수를 의미하고 some P``는 제네릭을 의미합니다.** 이것은 정확히 동일하지 않습니다. some P는 호출 사이트가 구체 타입을 결정하도록 합니다. any P는 인수를 상자에 넣도록 합니다. 가능하면 some을 사용하세요. 호출자가 선택한다는 점에서 nonisolated`와 유사합니다.

  • any가 값 의미론인 경우 any로 캡슐화를 얻을 수 있습니다. 상자 자체가 값 타입인 경우(복사 가능, 동등성 등) any 값은 값 의미론을 가질 수 있습니다. any Error가 그 예입니다. any View는 iOS 18/Xcode 26 이전까지는 그렇지 않으며, 이후에는 프로토콜이 ~Copyable이 됩니다.


7. API 설계 — 당신의 API는 약속입니다

  • 기본 구현이 없는 프로토콜의 메서드를 public으로 표시하지 마세요. 사용자가 준수해야 하는 메서드만 공개하세요.
  • 저장 프로퍼티를 public으로 절대 만들지 마세요. 항상 비공개로 유지하고 필요한 경우 계산된 getter를 제공하세요.
  • 프로토콜 요구사항에 기본값이 있는 경우 optional 대신 기본 구현을 사용하세요.
  • 매개변수는 가능한 가장 덜 제한적인 타입을 받으세요. 예: [String] 대신 some Sequence<String>.
  • 모든 public 선언에 문서화 주석을 작성하세요. /// 스타일을 사용하세요.
  • @available을 사용하여 플랫폼 및 Swift 버전을 표시하세요.
  • 폐기 예정인 API에는 @available(*, deprecated, renamed: "newName")를 사용하세요.

8. 성능 및 ARC

Swift의 ARC는 참조 타입의 수명을 관리하지만, 때때로 예상치 못한 보유 주기를 생성할 수 있습니다.

  • 순환 참조는 [weak self] 또는 [unowned self]로 끊으세요. [weak self]를 선호하세요. 약한 참조는 자동으로 nil이 될 수 있습니다. 소유되지 않은 참조는 객체가 해제된 후 nil이 될 수 없습니다.
  • 클로저가 캡처하는 객체의 수명과 일치하지 않을 때 보유 주기가 발생합니다. 객체 내부의 클로저가 객체를 다시 참조하면 주기가 생성됩니다.
  • 구조체가 값을 변경할 때 불필요한 복사를 피하세요. 특히 컬렉션에서. 성능에 민감한 코드에서는 복사-시-쓰기를 사용하세요.
  • final 클래스는 상속 불가를 통해 가상 디스패치를 제거하여 더 나은 성능을 제공합니다. 특히 성능이 중요한 코드에서 클래스를 final로 표시하는 것을 고려하세요.

9. Swift Testing

Swift Testing은 XCTest를 대체하는 현대적인 테스트 프레임워크입니다.

  • import Testing을 사용하세요.
  • 테스트 함수는 @Test로 표시하고, 테스트 인수는 #expect 매크로를 사용하세요.
  • #expect는 조건을 테스트하고, 실패 시 진단을 제공합니다.
  • await와 같은 비동기 코드를 테스트하려면 @Test 함수를 비동기로 표시하세요.
  • @Suite를 사용하여 관련 테스트를 그룹화하세요.
  • @Test(.disabled("이유"))로 테스트를 비활성화하세요.
  • #expect(throws:)를 사용하여 던져지는 오류를 테스트하세요.
  • #expect는 사용자 정의 실패 메시지를 위해 comment: 매개변수를 지원합니다.

10. 매크로

매크로는 컴파일 시간에 코드를 생성합니다.

  • #Preview 매크로는 뷰 인스턴스를 생성하여 빠른 시각적 미리보기를 제공합니다.
  • #Predicate 매크로는 Predicate를 생성합니다.
  • #require 매크로는 조건이 충족되지 않으면 현재 함수를 종료합니다. guard가 트리거되면 실패를 기록합니다.
  • 사용자 정의 매크로는 컴파일 시간에 코드를 생성할 수 있습니다. 자세한 내용은 Swift Evolution SE-0389를 참조하세요.

Swift의 진화

Swift는 빠르게 진화하고 있습니다. 에이전트는 최신 Swift Evolution 제안을 최신 상태로 유지해야 합니다.

  • Swift 6.2의 @concurrent 및 nonisolated 기본값 — async는 더 이상 현재 Actor를 떠나지 않습니다.
  • ~Copyable 타입 — 고유 소유권을 위한 비복사 타입.
  • 접근 가능한 동시성 — Swift 6.2의 @concurrent 및 nonisolated 기본값.
  • 매크로 — #Preview, #Predicate, #require.
  • Swift Testing — XCTest를 대체하는 현대적인 테스트 프레임워크.
  • some 및 any — 프로토콜 타입 매개변수에 대한 명확한 의미.
  • 소유권 매개변수 — borrowing, consuming, mutating/inout.
  • Actor 재진입 및 비-FIFO 순서.
  • @unchecked Sendable 및 nonisolated(unsafe) — 신중하게 사용하세요.

요약

Swift는 점진적 공개 언어입니다.

기본값으로 시작하고, 이유가 있을 때만 움직이세요.

  • 데이터 → struct/enum
  • 추상화 → 구체 타입 → some P → any P
  • 실행 → 단일 스레드 → async → @concurrent → actor
  • 메모리 → Array/String → InlineArray/Span
  • 안전성 → 안전한 API → Unsafe*

그리고 항상 프로파일링하세요. 정말로 거기에 도달할 필요가 없다면 최적화하지 마세요.


이 스킬은 Swift 6.3을 기준으로 작성되었습니다. Swift 6.4의 일부 기능은 ⚠로 표시되어 있습니다.

Individual skills in this repo

This repo contains 13 individual skills — each has its own dedicated page.

CharbelElBateh/personal-website

Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use `animate`.

CharbelElBateh/personal-website

Build an animation from scratch, making the decisions in the order that determines whether it feels right — should it animate at all, what purpose, which tool, which properties, which curve and duration, how it interrupts, how it exits. Writes the implementation. Use when asked to animate something, add motion, make a component feel alive, or build a transition. For critiquing existing motion use review-animations; for auditing a whole codebase use improve-animations.

CharbelElBateh/personal-website

Reverse-lookup glossary that turns a vague description of a web animation or motion effect into its exact term ("the bouncy thing when a popover opens" → Pop in; "the iOS rubber-band scroll" → Rubber-banding). Use when the user asks "what's it called when…", or describes a motion effect without knowing its name and wants the right word to prompt an AI or designer with. For naming an effect, not designing or building one.

CharbelElBateh/personal-website

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

CharbelElBateh/personal-website

Guide to Sonner, the React toast library — install and wire up the Toaster, pick the right toast() call, promise and loading toasts, updating, dismissing and persisting toasts, styling, theming and icons, positioning and multiple toasters. Use when working with Sonner or troubleshooting it — toasts that don't appear, appear twice, lose their styles, ignore Tailwind classes, sit behind a modal, or don't follow dark mode.

CharbelElBateh/personal-website

Try to break a piece of UI by feeding it worst-case data — long names, unbreakable emails, one-letter names, missing fields, huge counts, zero items, long labels, non-Latin text, emoji, extreme numbers — then render it behind a "Demo data / Worst case" toggle and report everything that broke, with the fix for each. Use when the user asks to stress-test, break, or find edge cases in a component or screen, or to "try the worst case". For visual design critique use emil-design-eng; for motion use review-animations.

CharbelElBateh/personal-website

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

CharbelElBateh/personal-website

Search a codebase or UI for places that don't animate but should, and reject everything that shouldn't. Read-only; it proposes motion with exact values, it does not implement it. Use when the user asks "what could be animated here?" or wants to "make this feel more alive". For fixing existing animations, use improve-animations or review-animations instead.

CharbelElBateh/personal-website

Survey a codebase's animation and motion code as a senior motion advisor, then produce a prioritized audit and self-contained implementation plans for other agents (or cheaper models) to execute. Read-only on source code — it plans improvements, it does not apply them. Use when the user asks to "improve the animations", "audit the motion", "make this app feel better", or wants a roadmap of animation fixes rather than a review of a single diff.

CharbelElBateh/personal-website

Make a web app feel native on a phone — the small CSS and meta-tag fixes that separate "a website in a browser" from something that feels installed. Covers sticky hover states, tap highlight flashes, the 100vh bug, inputs that zoom the page, laggy taps, pull-to-refresh hijacking scroll, content under the notch, long-press selecting button text, carousels that scroll the wrong way, mismatched status bars, and the rule that you test on real hardware. Use when a web app is being built for or reviewed on mobile, when something "works in Chrome but feels wrong on my phone", when building a PWA, a bottom sheet, a carousel, a full-screen layout, or any touch interaction. For motion itself use animate; for React Native use animate-expo.

CharbelElBateh/personal-website

Pick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Build multiple genuinely different versions of a UI piece you describe, rendered behind a visual picker so you can flip through them live and promote the one that feels right. Only runs when explicitly invoked; it does not trigger on its own.

CharbelElBateh/personal-website

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

관련 스킬