From apple-craft
Apple 플랫폼 개발 어시스턴트 — Swift, SwiftUI, UIKit, AppKit, Xcode 빌드/프리뷰/디버깅, 코드 작성/수정/리팩토링/마이그레이션, API 설명, 성능 문제 해결. 일반 Apple 개발 작업의 기본 진입점입니다. 코드 리뷰/PR 검토는 apple-review, 처음부터/전체 구현이나 장기 대규모 작업은 apple-harness를 사용합니다. iOS, macOS, watchOS, visionOS. swift, swiftui, uikit, appkit, xcode, 빌드, 프리뷰, 디버깅, 코드 작성, 코드 수정, 리팩토링, 마이그레이션, 아키텍처, SPM, CocoaPods, xcodeproj, swift concurrency, combine, swiftdata, coredata, objective-c, swift package, 테스트, unit test, 시뮬레이터, instruments, 성능, 메모리, 크래시, build error, API 설명, 앱 개발, Apple 플랫폼 코딩, iOS 26, macOS 26, WWDC, 최신 API, 새 프레임워크.
How this skill is triggered — by the user, by Claude, or both
Slash command
/apple-craft:apple-craftThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
<example>
references/_index.mdreferences/alarmkit.mdreferences/appintents-updates.mdreferences/assistive-access.mdreferences/attributedstring-updates.mdreferences/charts-3d.mdreferences/code-style.mdreferences/common-mistakes.mdreferences/foundation-models.mdreferences/liquid-glass-appkit.mdreferences/liquid-glass-swiftui.mdreferences/liquid-glass-uikit.mdreferences/liquid-glass-widgetkit.mdreferences/mapkit-geotoolbox.mdreferences/response-templates.mdreferences/storekit-updates.mdreferences/styled-text.mdreferences/swift-concurrency.mdreferences/swift-inline-array-span.mdreferences/swiftdata-inheritance.mdApple 플랫폼 통합 개발 어시스턴트 — Swift/SwiftUI/UIKit/AppKit 코드 작성·수정·디버깅 + Xcode MCP 연동. Xcode 26 참조 문서(20개 주제) 내장으로 최신 API도 정확하게 지원합니다.
아래 참조 문서의 내용을 학습 데이터보다 우선하는 정확한 정보로 사용하세요.
references/liquid-glass-swiftui.md 참조)apple-review로 전환합니다.apple-harness로 전환합니다.사용자 메시지를 분석하여 아래 모드 중 하나를 선택합니다.
| 모드 | 키워드 | 설명 |
|---|---|---|
| implement | 만들어, 작성, 적용, 구현, 추가, 코드, 리팩토링, 마이그레이션, build, create, add, apply, refactor | 코드 작성 + 빌드 검증. 참조 문서 매칭 시 최신 API 활용 |
| explore | 알려줘, 설명, 뭐가 바뀌었어, 차이, 어떻게, 비교, 추천, what, how, explain, diff, compare | API/코드 설명 + 코드 예시. DocumentationSearch로 공식 문서 검색 |
| troubleshoot | 에러, 오류, 안돼, 크래시, 빌드 실패, 느려, 성능, 메모리, error, crash, fix, debug, slow | 빌드 로그/코드 분석 + 수정. GetBuildLog, XcodeListNavigatorIssues 활용 |
| review | 리뷰, 코드 리뷰, review, 검토, 점검, PR 리뷰, audit, 봐줘, 확인해, 체크, 살펴, 분석, check, analyze, inspect | → apple-review 스킬로 전환 |
| harness | 처음부터, 전체, 기능 개발, 대규모, 전면 리팩토링, harness | → apple-harness 스킬로 전환 |
자동 선택: 키워드가 불명확하면 사용자 의도를 추론합니다. 코드 파일이 언급되면 implement, 질문형이면 explore, 에러 메시지가 포함되면 troubleshoot, 기존 코드에 대한 평가/의견 요청이면 review.
키워드 충돌 시 우선순위: 두 모드의 키워드가 동시에 등장하면, 사용자의 주요 의도를 기준으로 선택합니다. "에러 있는지 검토해줘" → review (검토가 주요 동사), "리뷰 결과 에러 수정해줘" → troubleshoot (수정이 주요 동사). 특히 리뷰/검토/점검/PR 리뷰가 명시되면 review를 우선하고, 처음부터/전체/전면/대규모가 명시되면 harness를 우선합니다. 그 외 구현/수정/디버깅/설명은 apple-craft가 담당합니다.
모든 모드에 공통으로 적용되는 워크플로우입니다. 참조 문서 매칭 여부와 관계없이 모든 Apple 플랫폼 작업에 적용합니다.
*.xcodeproj, Package.swift, Podfile, *.swift)Xcode MCP 서버가 연결되어 있으면 적극 활용합니다. 미연결 시에도 일반 도구(Bash, Read, Grep 등)로 대응합니다.
| 목적 | 도구 | 언제 사용 |
|---|---|---|
| 빠른 코드 진단 | XcodeRefreshCodeIssuesInFile | 코드 수정 후 즉시 (2초 이내) |
| 전체 빌드 | BuildProject + GetBuildLog | 변경 완료 후 검증 |
| UI 확인 | RenderPreview | SwiftUI 뷰 수정 시 |
| API 검색 | DocumentationSearch | 모르는 API, 시그니처 확인 |
| 코드 실행 | ExecuteSnippet | 동작 확인, 로직 검증 |
| 에러 목록 | XcodeListNavigatorIssues | troubleshoot 시작 시 |
references/code-style.md를 참조references/common-mistakes.md를 참조사용자 쿼리를 분석하여 아래 테이블에서 관련 참조 파일을 찾으세요.
| Topic | Reference File | Match Keywords | Platforms |
|---|---|---|---|
| Liquid Glass (SwiftUI) | references/liquid-glass-swiftui.md | glassEffect, Glass, GlassEffectContainer, liquid glass, 유리 | iOS, macOS, visionOS |
| Liquid Glass (UIKit) | references/liquid-glass-uikit.md | UIGlassEffect, UIGlassContainerEffect, UIScrollEdgeEffect | iOS |
| Liquid Glass (AppKit) | references/liquid-glass-appkit.md | NSGlassEffectView, NSGlassEffectContainerView | macOS |
| Liquid Glass (WidgetKit) | references/liquid-glass-widgetkit.md | widget glass, widgetRenderingMode, widgetAccentable | iOS, macOS, visionOS |
| FoundationModels | references/foundation-models.md | FoundationModels, SystemLanguageModel, LanguageModelSession, @Generable, Tool protocol, 온디바이스 LLM | iOS, macOS |
| Swift 6.2 Concurrency | references/swift-concurrency.md | @concurrent, nonisolated, Sendable, data race, actor, 동시성, async/await | All |
| InlineArray & Span | references/swift-inline-array-span.md | InlineArray, Span, MutableSpan, RawSpan, OutputSpan, UTF8Span | All |
| SwiftData Inheritance | references/swiftdata-inheritance.md | SwiftData, @Model, class inheritance, 클래스 상속, polymorphic | All |
| Visual Intelligence | references/visual-intelligence.md | Visual Intelligence, SemanticContentDescriptor, IntentValueQuery, 비주얼 인텔리전스 | iOS |
| AlarmKit | references/alarmkit.md | AlarmKit, AlarmManager, Alarm, AlarmPresentation, AlarmAttributes, 알람 | iOS, watchOS |
| WebKit + SwiftUI | references/webkit-swiftui.md | WebKit, WebView, WebPage, callJavaScript, 웹뷰 | iOS, macOS |
| StoreKit Updates | references/storekit-updates.md | StoreKit, AppTransaction, SubscriptionOfferView, in-app purchase, 인앱 결제, 구독 | iOS, macOS |
| 3D Charts | references/charts-3d.md | Chart3D, SurfacePlot, Chart3DPose, Chart3DCameraProjection, 3D 차트 | iOS, macOS, visionOS |
| MapKit GeoToolbox | references/mapkit-geotoolbox.md | MapKit, GeoToolbox, PlaceDescriptor, PlaceRepresentation, geocoding, 지도 | iOS, macOS |
| AppIntents Updates | references/appintents-updates.md | AppIntents, SnippetIntent, @ComputedProperty, @DeferredProperty, Shortcuts, 단축어, Spotlight | iOS, macOS, watchOS |
| AttributedString | references/attributedstring-updates.md | AttributedString, TextAlignment, WritingDirection, LineHeight, 속성 문자열 | iOS, macOS |
| Toolbar Features | references/swiftui-toolbar.md | toolbar, ToolbarSpacer, DefaultToolbarItem, SearchToolbarBehavior, 툴바 | iOS, macOS |
| Styled Text Editing | references/styled-text.md | TextEditor, AttributedTextSelection, textFormattingDefinition, 스타일 텍스트 | iOS, macOS |
| Assistive Access | references/assistive-access.md | AssistiveAccess, AssistiveAccessScene, accessibilityAssistiveAccessEnabled, 접근성 | iOS |
| visionOS Widgets | references/visionos-widgets.md | supportedMountingStyles, widgetTexture, levelOfDetail, showsWidgetContainerBackground | visionOS |
Grep: pattern="검색어" path="${CLAUDE_PLUGIN_ROOT}/skills/apple-craft/references/"
mcp__xcode__DocumentationSearch 사용Swift/Xcode 프로젝트에서 코드를 작성하거나 수정할 때 사용합니다.
references/code-style.md를 Read하여 참조references/common-mistakes.md를 Read하여 흔한 실수 방지mcp__xcode__XcodeRefreshCodeIssuesInFile로 빠른 진단 (1순위)mcp__xcode__BuildProject로 전체 빌드mcp__xcode__GetBuildLog로 로그 확인 → 수정 → 재빌드빌드 성공은 컴파일 성공일 뿐, 사용자 요구사항 충족을 의미하지 않는다.
요구사항 대조:
참조 문서 Best Practices 최종 확인:
references/common-mistakes.md를 Read하여 안티패턴 최종 대조판정:
회귀 제한: Phase 2 → 3 → 3.5 루프는 최대 2회. 2회 회귀 후에도 미충족이면 사용자에게 현재 상태를 보고하고 판단 요청.
mcp__xcode__RenderPreview로 SwiftUI 프리뷰 확인응답 형식은 references/response-templates.md를 참조하세요.
Apple 프레임워크 API 설명, 변경 사항 비교, 사용법 안내를 할 때 사용합니다.
mcp__xcode__DocumentationSearch로 공식 문서 검색 (매칭 여부와 무관하게 활용)mcp__xcode__ExecuteSnippet으로 API 동작 확인 가능응답 형식은 references/response-templates.md를 참조하세요.
빌드 에러, 런타임 크래시, 성능 이슈, API 사용 오류를 해결할 때 사용합니다.
mcp__xcode__GetBuildLog 또는 mcp__xcode__XcodeListNavigatorIssues로 에러 확인references/common-mistakes.md를 Read하여 알려진 패턴 확인mcp__xcode__XcodeRefreshCodeIssuesInFile로 빠른 진단mcp__xcode__BuildProject로 재빌드응답 형식은 references/response-templates.md를 참조하세요.
@Test, #expect) 사용#Preview 매크로 사용DocumentationSearch로 지원합니다.mcp__xcode__DocumentationSearch로 최신 시그니처를 확인하세요.npx claudepluginhub oozoofrog/oozoofrog-plugins --plugin apple-craftSupports iOS app development: writes Swift/SwiftUI/UIKit code, architects apps, debugs crashes, handles navigation/networking/persistence/animations/performance, configures Xcode/App Store.
Coordinates iOS/SwiftUI workflows with best-practice guides, correctness checklists, topic routing, and Apple API references for building, reviewing, refactoring, and debugging apps.
Provides expert guidance for iOS/macOS development with Swift, SwiftUI, UIKit, Core Data, Combine, Xcode projects, app architectures, build errors, and performance optimization.