Swift Concurrency Migration Skill MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

완전한 Swift 동시성 마이그레이션 가이드 텍스트 및 코드 예제
Claude는 async/await 관용어를 환각하는 대신 가이드를 인용합니다.
Claude.ai용 Claude Code /plugin 또는 ZIP을 통해 설치 가능
.claude/settings.json을 통한 팀 자동 프로비저닝
Swift 6 엄격한 동시성 채택 및 Sendable 감사에 유용합니다.

라이브 데모

실제 사용 모습

swift-concurrency-migration-skill.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "swift-concurrency-migration-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "kylehughes/the-unofficial-swift-concurrency-migration-skill"
      ],
      "_inferred": false
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "swift-concurrency-migration-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "kylehughes/the-unofficial-swift-concurrency-migration-skill"
      ],
      "_inferred": false
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "swift-concurrency-migration-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "kylehughes/the-unofficial-swift-concurrency-migration-skill"
      ],
      "_inferred": false
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "swift-concurrency-migration-skill": {
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "kylehughes/the-unofficial-swift-concurrency-migration-skill"
      ],
      "_inferred": false
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "swift-concurrency-migration-skill",
      "command": "claude",
      "args": [
        "plugin",
        "marketplace",
        "add",
        "kylehughes/the-unofficial-swift-concurrency-migration-skill"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "swift-concurrency-migration-skill": {
      "command": {
        "path": "claude",
        "args": [
          "plugin",
          "marketplace",
          "add",
          "kylehughes/the-unofficial-swift-concurrency-migration-skill"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add swift-concurrency-migration-skill -- claude plugin marketplace add kylehughes/the-unofficial-swift-concurrency-migration-skill

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Swift Concurrency Migration Skill

DispatchQueue가 많은 모듈을 async/await로 변환

👤 레거시 코드베이스를 현대화하는 iOS/macOS 엔지니어 ⏱ ~90 min advanced

언제 쓸까: DispatchQueue, 완료 처리기 및 @escaping 클로저를 혼합하는 모듈을 소유하고 있습니다. 비동기/대기를 원합니다.

사전 조건

Swift 5.9+를 사용하는 Xcode(엄격한 동시성을 원하는 경우 Swift 6 모드) — App Store에서 Xcode 설치
스킬 장착 — /플러그인 마켓플레이스에 kylehughes/the-unofficial-swift-concurrency-migration-skill 추가

흐름

마이그레이션 계획을 요청하세요

Swift 동시성 마이그레이션 가이드를 인용하여 NetworkService.swift를 async/await로 마이그레이션하는 과정을 안내해 주세요.✓ 복사됨

→ 가이드에 있는 기사라는 이름의 계획 참조
단계별로 적용

공개 API 표면으로 시작하세요. 완료 처리기 메서드를 async/await로 변환하세요.✓ 복사됨

→ 코드는 래퍼 콜백이 아닌 관용적 비동기 API를 사용합니다.
취소 및 격리 처리

작업 취소를 추가하고 캐시에 대한 행위자 격리를 결정합니다.✓ 복사됨

→ 적절한 Task.checkCancellation + 명시적 행위자 격리

결과: 모듈은 Apple의 자체 지침에 따른 추론을 통해 깔끔하게 마이그레이션되었습니다.

함정

소유권을 수정하지 않고 withCheckedContinuation에서 콜백 래핑 — 먼저 루트 API를 마이그레이션하세요. 연속을 영구 브리지로 두지 마십시오

함께 쓰기: the-unofficial-swift-programming-language-skill

Sendable 적합성 경고에 대한 코드베이스 감사

👤 Swift 6 엄격한 동시성 검사를 활성화하는 팀 ⏱ ~60 min advanced

언제 쓸까: 언어 모드를 바꾸면 이제 컴파일러가 비명을 지르고 있습니다.

흐름

경고 클러스터링

이 빌드 로그의 Sendable 경고를 카테고리(값 유형, 클래스, 클로저 캡처)별로 그룹화하세요.✓ 복사됨

→ 가이드의 일반적인 수정 사항이 포함된 버킷 지우기
정식 수정사항 적용

각 버킷에 대해 Swift 동시성 마이그레이션 가이드의 수정 사항을 적용하세요. 장단점을 설명하세요.✓ 복사됨

→ 인용 @unchecked를 수정하여 정당한 경우에만 보낼 수 있음

결과: 각 선택에 대한 추론을 문서화하여 컴파일하는 Swift 6 빌드입니다.

함정

@unchecked Sendable을 소음기로 사용 — 가이드에서는 이에 대해 명시적으로 경고합니다. 문서화된 스레드 안전성을 갖춘 박스형 레거시 API를 예약하세요.

함께 쓰기: xcodebuild

액터와 GlobalActor를 소개할 위치 결정

👤 격리 경계를 그리는 건축가 ⏱ ~30 min intermediate

언제 쓸까: 공유 상태를 모델링하고 있는데 어떤 행위자 취향이 적합한지 확신할 수 없습니다.

흐름

상태를 설명하세요.

상태 설명: <사용자 프로필 캐시; 읽기가 많고 5분마다 쓰기>.✓ 복사됨

→ 스킬은 가이드의 액터/GlobalActor 섹션을 참조합니다.
추천 받기

인용문과 함께 배우와 GlobalActor를 추천합니다.✓ 복사됨

→ 일반적인 모범 사례가 아닌 가이드 섹션을 기반으로 한 권장 사항

결과: 검토를 통해 방어할 수 있는 격리 모델입니다.

함께 쓰기: jetpack-compose-skill

조합

다른 MCP와 조합해 10배 효율

swift-concurrency-migration-skill + xcodebuild

반복: 마이그레이션 → 빌드 → 경고 수정 → 반복

각 편집 후 xcodebuild를 실행하고 Swift 6 경고를 스킬에 다시 제공합니다.✓ 복사됨

swift-concurrency-migration-skill + the-unofficial-swift-programming-language-skill

동시성 관련 지침과 함께 일반적인 Swift 언어 질문

일반 매개변수 팩에 대해 설명하세요. 그런 다음 동시성 마이그레이션에 적용합니다.✓ 복사됨

swift-concurrency-migration-skill + jetpack-compose-skill

크로스 플랫폼 작업을 수행할 때 Android Compose 코루틴과 Swift 동시성을 대조해 보세요.

우리 iOS 팀은 async/await를 사용합니다. Android 팀은 코루틴을 사용합니다. 공유 API 계층의 동시성 패턴을 정렬합니다.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
migrating-to-swift-concurrency (SKILL)	natural-language code questions	Swift 동시성을 다루고 신뢰할 수 있는 답변을 원할 때마다	0

비용 및 제한

운영 비용

API 쿼터: 없음
호출당 토큰: 가이드가 로드되는 양에 따라 다릅니다. 질문 범위를 좁게
금액: 무료
팁: 스킬이 관련 섹션만 로드하도록 정확한 질문(파일 이름 지정, 경고 이름 지정)을 하십시오.

보안

권한, 시크릿, 파급범위

자격 증명 저장: 자격 증명 없음

데이터 외부 송신: 없음 — 콘텐츠가 로컬로 번들로 제공됩니다.

이것은 Apple 가이드의 비공식 패키지입니다. 여전히 가이드 텍스트이지만 최근 Swift 릴리스에 변경 사항이 도입되었는지 라이브 Apple 문서에서 확인하세요.

문제 해결

자주 발생하는 오류와 해결

스킬이 발동되지 않습니다

SKILL.md 설명을 확인하세요. 그것이 바로 이 설명을 유발하는 것입니다. 또한 Claude Code 또는 Agent Skill 호환 클라이언트를 실행하고 있는지 확인하세요.

확인: head ~/.claude/skills/migrating-to-swift-concurrency-skill/SKILL.md

답변은 섹션을 인용하지 않고 일반적인 느낌을 줍니다.

명시적으로 프롬프트: 'Swift 동시성 마이그레이션 가이드 섹션을 인용하세요'. 스킬에는 텍스트가 있습니다. 이를 사용하도록 하세요.

/plugin을 통한 설치 실패

Claude Code를 /plugin 마켓플레이스를 지원하는 버전으로 업데이트하세요. 또는 릴리스 ZIP을 다운로드하세요.

확인: claude --version

대안

Swift Concurrency Migration Skill 다른 것과 비교

대안	언제 쓰나	단점/장점
the-unofficial-swift-programming-language-skill	동시성 가이드가 아닌 Swift 언어 책을 원합니다.	더 광범위하고 마이그레이션 중심이 덜함
xcodebuild	코드를 마이그레이션하지 않고 빌드/테스트를 자동화하고 싶습니다.	직교 툴링

Swift Concurrency Migration Skill