# Apple Craft

> Apple 플랫폼 개발을 돕습니다. Swift, SwiftUI, UIKit, AppKit, Xcode 빌드/프리뷰/디버깅, 최신 Apple API 참조가 필요할 때 사용하고 장기 오케스트레이션은 apple-harness로 넘깁니다.

- Skill: `oozoofrog/apple-craft` (Agent Skill, multi-file: 28 files)
- Install (CLI): `npx skillmds@latest add oozoofrog/apple-craft`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oozoofrog/apple-craft/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: oozoofrog (https://skillmd.com/u/oozoofrog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oozoofrog/apple-craft

---


# Apple Craft

원본 `apple-craft` 플러그인의 Codex 버전입니다. Xcode 도구와 번들 reference docs를 함께 사용합니다.

## When to use
- Swift/SwiftUI/UIKit/AppKit의 소규모~중간 규모 구현·수정·트러블슈팅이 필요할 때
- Xcode 빌드/프리뷰/진단과 Apple API 참조를 함께 봐야 할 때
- 장기 오케스트레이션 없이 한 세션 또는 짧은 루프로 해결할 수 있을 때

## Do not use when
- 처음부터 끝까지 여러 라운드로 기능을 밀어야 하는 장기 작업 → `apple-harness`
- 구현보다 코드/PR 리뷰가 주목적인 작업 → `apple-review`
- Apple 플랫폼과 무관한 일반 개발 작업

## Quick start
1. 작업을 `implement / explore / troubleshoot`로 구분한다.
2. 프로젝트 구조와 현재 문제 범위를 먼저 확인한다.
3. 필요한 Apple 문서와 reference를 최소량만 읽는다.
4. 수정 후 가능하면 빌드·프리뷰·diagnostics로 검증한다.

## Knowledge priority
1. `DocumentationSearch` 같은 공식 도구 결과
2. `references/`에 있는 번들 Apple 문서
3. 현재 프로젝트 코드와 빌드 로그
4. 일반 모델 기억

## Use references
- `references/_index.md`
- `references/common-mistakes.md`
- `references/code-style.md`
- 필요한 프레임워크별 문서 한두 개만 추가 로드

## Workflow
1. 작업 유형을 구분한다: `implement`, `explore`, `troubleshoot`.
2. Xcode 프로젝트/패키지 구조와 현재 문제 범위를 먼저 확인한다.
3. 관련 reference doc과 공식 검색 결과를 최소한만 읽는다.
4. 구현·설명·수정 작업을 수행한다.
5. 가능하면 `XcodeRefreshCodeIssuesInFile`, `BuildProject`, `GetBuildLog`, `RenderPreview`로 검증한다.
6. 리뷰 중심 작업은 `apple-review`, 장기 루프는 `apple-harness`를 사용한다.

## Scripts
- `scripts/preflight.sh` — 참조 문서 존재 확인
- `scripts/sync-docs.sh` — Xcode 번들 문서를 로컬 reference로 동기화

## Review Harness
- mode: optional
- 공통 기준: `../../../docs/review-harness.md`
- generator: 구현·수정·설명 작업을 수행한다
- evaluator: `apple-review`와 `BuildProject` / `RenderPreview` / diagnostics 결과로 skeptical pass를 수행한다
- 평가축: buildability, API 사용 정확성, lifecycle/concurrency 안정성, UI 검증 가능성
- artifacts/evidence: build log, preview screenshot, issue navigator, 수정 파일 목록
- pass condition: 관련 Apple API/수명주기/동시성 리스크가 설명 가능하고, 가능하면 빌드·프리뷰 증거가 확보돼야 한다
- 자동 다음 행동: `pass`면 종료, `refine`이면 최소 수정 후 재빌드, `pivot`이면 구현 전략 변경, `escalate`면 `apple-review` 또는 장기 작업이면 `apple-harness`로 넘긴다

## Output expectation
- 읽은 reference 문서
- 적용/수정 내용
- 빌드·프리뷰·진단 결과