twostraws/Swift-Concurrency-Agent-Skill

Claude Code, Codex, Cursor, Gemini와 같은 AI 코딩 어시스턴트가 더 나은 Swift 동시성 (Concurrency) 코드를 작성할 수 있도록 돕는 에이전트 스킬 (Agent skill)입니다. LLM이 실제로 범하는 실수들을 겨냥하여 async/await, actors, Sendable, task groups, @concurrent, 구조적 동시성 (Structured concurrency) 등을 다룹니다.

또한 다음 항목도 이용 가능합니다:

Swift Agent Skills에서 Swift 및 Apple 플랫폼 개발을 위한 더 많은 에이전트 스킬을 찾아보세요.

Swift Concurrency Agent Skill 마켓플레이스를 추가한 다음, 플러그인을 설치하세요:

/plugin marketplace add twostraws/Swift-Concurrency-Agent-Skill
/plugin install swift-concurrency-pro@swift-concurrency-agent-skill

npx skills add https://github.com/twostraws/swift-concurrency-agent-skill --skill swift-concurrency-pro

만약 npx: command not found 에러가 발생한다면, 현재 Node가 설치되어 있지 않음을 의미합니다. Homebrew를 통해 Node를 설치하려면 다음 명령어를 실행해야 합니다:

brew install node

만약 이 명령어도 실패한다면, 대개 Homebrew를 먼저 설치해야 함을 의미합니다.

npx를 사용할 때, 설치 과정에서 사용하고자 하는 에이전트를 정확히 선택할 수 있습니다. 또한 해당 스킬을 단일 프로젝트에만 설치할지, 아니면 모든 프로젝트에서 사용할 수 있도록 설정할지도 선택할 수 있습니다.

또는, 이 저장소 전체를 클론(Clone)하여 원하는 방식으로 설치할 수도 있습니다.

Xcode를 사용 중이라면, YouTube 영상인 'How to Install and Use Agent Skills in Xcode'를 통해 단계별 안내를 확인하세요.

이 스킬의 이름은 Swift Concurrency Pro이며, 다양한 방식으로 실행할 수 있습니다. 예를 들어, Claude Code에서는 다음과 같이 사용합니다:

/swift-concurrency-pro

Codex에서는 다음과 같이 사용합니다:

$swift-concurrency-pro

두 경우 모두 부분적인 리뷰만 원하는 경우 특정 지침을 제공할 수 있습니다. 예를 들어, Claude에서는 /swift-concurrency-pro Make sure my project takes full advantage of Swift concurrency라고 입력하거나, Codex에서는 $swift-concurrency-pro Help me migrate this project to task groups라고 입력할 수 있습니다.

자연어를 사용하여 스킬을 실행할 수도 있습니다:

이 프로젝트에서 잠재적인 동시성 문제(concurrency problems)를 찾기 위해 Swift Concurrency Pro 스킬을 사용하세요.

저는 Swift 동시성(Swift concurrency)에 관한 책을 집필했으며, 새로운 기능이 추가될 때마다 정기적으로 업데이트하고 있습니다. 또한 Swift의 새로운 기능들을 소개하는 포괄적인 기사 세트도 작성해 왔으며(예시는 여기, 여기, 그리고 여기를 참조하세요), 따라서 Swift 동시성의 구석구석을 이해하는 것을 제 본업으로 삼아왔습니다.

이 스킬은 그 모든 노력의 결과물입니다. 여기에 포함된 규칙들은 LLM(Large Language Models)이 흔히 범하는 Swift 동시성 실수들을 직접적으로 겨냥하며, LLM이 학습하지 못한 새로운 기능, 자주 실수하는 오래된 기능, 그리고 코드를 안전하고 효율적으로 유지하는 데 도움이 되는 패턴들을 다룹니다.

이 스킬은 단순히 지금까지의 모든 Swift 동시성 조언을 모아놓은 쓰레기통이 아닙니다. 에이전트(Agents)들은 이미 async/await, 액터(actors), 그리고 구조적 동시성(structured concurrency)의 기초에 대해 탄탄한 지식을 갖추고 있으므로, 이미 알고 있는 내용을 다시 가르치려 하는 스킬은 토큰(tokens)만 낭비할 뿐입니다.

이 스킬은 실제로 영향력을 미치는 부분에 집중합니다.

새로운 검사 항목을 추가하거나, 기존 검사 항목을 개선하거나, 이 README를 편집하는 것 등 모든 기여를 환영합니다. 누구든 환영합니다!

• Markdown을 간결하게 유지하세요. 스킬을 사용하는 데에는, 특히 SKILL.md의 경우 토큰 비용이 발생하므로 사용자의 토큰 예산을 존중해 주세요.
• LLM이 이미 알고 있는 내용을 반복하지 마세요. 이득 없이 토큰만 낭비하게 됩니다. 엣지 케이스(edge cases), 의외의 상황, 소프트 폐기(soft deprecations) 및 이와 유사한 사례에 집중하세요.
• 모든 작업은 최대한 많은 사람에게 혜み을 줄 수 있도록 MIT 라이선스(MIT license) 하에 배포되어야 합니다.

반드시 행동 강령(Code of Conduct)을 준수해 주세요.

Swift Concurrency Pro는 원래 Hacking with Swift에서 무료 Swift 튜토리얼을 작성하는 Paul Hudson에 의해 만들어졌습니다. 이 프로젝트는 상업적 이용, 수정, 배포 및 개인적 이용을 허용하는 MIT 라이선스 하에 제공됩니다.