Community코딩 & 개발github.com

steipete/swift-concurrency-expert

Swift 동시성 검토/수정: 컴파일러 오류, Sendable, 격리, 문제 해결.

swift-concurrency-expert란 무엇인가요?

이 스킬은 Swift 6.2 이상 코드베이스에서 발생하는 동시성 관련 컴파일러 오류를 검토하고 수정하는 AI 에이전트를 위한 전문 도구입니다. 주로 Swift의 Actor 격리, Sendable 안전성, 그리고 최신 동시성 패턴을 적용하여 데이터 경합(data-race) 없이 기존 동작을 최소한으로 변경하는 수정을 제안합니다. Claude Code, Cursor, Codex 등 다양한 AI 코딩 에이전트와 함께 사용할 수 있으며, SKILL.md 문서에 정의된 워크플로우를 따라 문제 진단, 가장 안전한 수정 적용, 참고 자료 확인을 수행합니다. 특히 UI 바인딩 타입에는 `@MainActor`를, 백그라운드 작업에는 `nonisolated` 또는 `actor`를 사용하도록 안내하며, `@unchecked Sendable` 사용을 지양합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/swift-concurrency-expert

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

Swift 동시성 전문가

참고: @Dimillian의 Dimillian/Skills에서 복사되었습니다 (2025-12-31).

개요

Swift 6.2+ 코드베이스에서 발생하는 Swift 동시성 문제를 검토하고 수정합니다. Actor 격리, Sendable 안전성 및 최신 동시성 패턴을 적용하여 최소한의 동작 변경으로 문제를 해결합니다.

워크플로우

1. 문제 분류

  • 정확한 컴파일러 진단 메시지와 문제가 있는 심볼(Symbol)을 파악합니다.
  • 현재 Actor 컨텍스트(@MainActor, actor, nonisolated)와 기본 Actor 격리 모드 활성화 여부를 확인합니다.
  • 코드가 UI에 바인딩되어 있는지, 아니면 메인 Actor 외부에서 실행되어야 하는지 확인합니다.

2. 가장 안전한 최소 수정 적용

데이터 경합 안전성을 만족시키면서 기존 동작을 유지하는 수정을 우선합니다.

일반적인 수정 사항:

  • UI 바인딩 타입: 타입 또는 관련 멤버에 @MainActor 어노테이션을 추가합니다.
  • 메인 Actor 타입의 프로토콜 준수: 준수를 격리시킵니다 (예: extension Foo: @MainActor SomeProtocol).
  • 전역/정적 상태: @MainActor로 보호하거나 Actor 내부로 이동합니다.
  • 백그라운드 작업: 무거운 작업을 nonisolated 타입의 @concurrent 비동기 함수로 이동하거나, actor를 사용하여 변경 가능한 상태를 보호합니다.
  • Sendable 오류: 변경 불가능/값 타입을 선호하며, 올바른 경우에만 Sendable 준수를 추가합니다. 스레드 안전성을 증명할 수 있는 경우가 아니라면 @unchecked Sendable을 사용하지 않습니다.

참고 자료

  • Swift 6.2 변경 사항, 패턴 및 예제는 references/swift-6-2-concurrency.md를 참조하십시오.
  • SwiftUI 관련 동시성 지침은 references/swiftui-concurrency-tour-wwdc.md를 참조하십시오.

Individual skills in this repo

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

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬