접근성 감사 실행

App Store 제출이 임박했을 때; VoiceOver/Dynamic Type 커버가 필요할 때. 기본 VoiceOver 안내를 통과하는 앱

Axiom (xOS Dev Skills) — 설치 & 라이브 데모

왜 쓰나요

핵심 기능

SwiftUI 우선 패턴; UIKit은 필요한 경우에만
적절한 actor 격리가 있는 @Observable (iOS 17+) ViewModel
구조화된 동시성 — Task 누수, 누락된 취소 표시
값 타입 편향; 필요한 경우가 아니면 struct/enum이 class보다 우선
접근성 감사 (VoiceOver, Dynamic Type, 대비)
App Store 준비 체크리스트
Xcode 프로젝트 위생 — 수동 .pbxproj 편집 없음

라이브 데모

실제 사용 모습

준비됨

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: Axiom (xOS Dev Skills)

ViewModel을 @Observable로 마이그레이션

👤 iOS 17+를 채택하는 iOS 개발자 ⏱ ~45 min advanced

언제 쓸까: 앱이 iOS 17+이지만 ViewModel이 여전히 ObservableObject + @Published를 사용할 때.

흐름

인벤토리

Axiom: 프로젝트의 모든 ObservableObject + @Published를 나열하세요. 리프 vs 공유 구분하세요.✓ 복사됨

→ 형태 + 의존성 힌트가 있는 목록
하나 마이그레이션

ProfileViewModel을 @Observable로 리팩토링하세요. 공개 API를 안정적으로 유지하세요. 뷰 소비자의 바인딩을 업데이트하세요.✓ 복사됨

→ VM 마이그레이션됨; 뷰에서 @Bindable 사용됨; @Published 없음
확인

스킴에 대해 xcodebuild를 실행하세요. 경고를 보고하세요.✓ 복사됨

→ 깨끗한 빌드; Swift 6 경고 없음

결과: 더 깨끗한 뷰가 있는 현대적인 @Observable 코드베이스

함정

기존 테스트가 @Published 프로젝션($name)에 의존 — 테스트를 다시 작성해야 함; 모든 액세스 패턴이 직접 매핑되지는 않음

함께 쓰기: filesystem · ios-simulator-mcp

Swift 6 동시성 경고 수정

👤 Swift 6 엄격한 동시성을 준비하는 iOS 개발자 ⏱ ~60 min advanced

언제 쓸까: 빌드가 Sendable / actor 경고로 노랗게 표시될 때.

흐름

분류

Axiom concurrency-clean: 경고를 분류하세요: (1) actor 격리, (2) Sendable 준수, (3) 데이터 레이스 위험.✓ 복사됨

→ 분류된 목록
actor 격리 수정

1번 카테고리부터 처리하세요. 최소 수정 제안; UI 타입에는 전역 격리보다 @MainActor를 선호.✓ 복사됨

→ 수술적 변경; 일괄 @MainActor 살포 없음

결과: 의도적인 동시성 경계가 있는 깨끗한 Swift 6 빌드

함정

@MainActor를 '경고 침묵' 단축키로 과용 — 스킬이 이를 표시; 대신 적절한 actor 설계 사용

조합

다른 MCP와 조합해 10배 효율

axiom-xos-skill + ios-simulator-mcp

스킬 권장 사항 적용 + 시뮬레이터에서 스모크 테스트

Axiom: ProfileVM 마이그레이션. 그런 다음 iOS-Simulator: 실행, 프로필 화면 스크린샷.✓ 복사됨

axiom-xos-skill + filesystem

프로젝트 전체에 패치 적용

Axiom concurrency-clean: src/를 위한 패치 생성. Filesystem: 적용.✓ 복사됨

axiom-xos-skill + xcodebuildmcp

리팩토링 후 빌드 확인

마이그레이션 후, XcodeBuild: 시뮬레이터용 빌드. 경고 보고.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
vm_migrate_observable	viewmodel_path	VM별 마이그레이션
concurrency_clean	scope	Swift 6 준비
a11y_scan	scope	릴리스 전
appstore_checklist	(없음)	제출 전
xcode_hygiene	project	주기적 정리

비용 및 제한

운영 비용

API 쿼터: 해당 없음
호출당 토큰: 프로젝트 스캔 10k–40k 토큰
금액: 무료
팁: 감사를 하나의 기능/폴더로 범위 제한; 거대한 앱 전체에 팬아웃하지 말 것

보안

권한, 시크릿, 파급범위

최소 스코프: filesystem-read filesystem-write

자격 증명 저장: 없음

데이터 외부 송신: 없음

스킬은 의견 있음; UIKit 우선 또는 Combine을 사용하는 팀이라면 마찰이 예상됨

문제 해결

자주 발생하는 오류와 해결

마이그레이션이 @Bindable 사용을 깨뜨림

일부 뷰에 @Bindable 래퍼가 필요; 스킬이 추가해야 함 — 놓친 것 없는지 확인

동시성 수정이 자동으로 의미를 변경

마이그레이션 후 항상 테스트 실행; 동시성 변경은 미묘함

A11y 제안이 보일러플레이트처럼 느껴짐

스킬은 Apple HIG를 따름; 자신의 레이블로 강화

대안

Axiom (xOS Dev Skills) 다른 것과 비교

대안	언제 쓰나	단점/장점
AvdLee Swift Concurrency Skill	동시성만 필요하고 더 넓은 번들이 필요 없을 때	더 좁음
Apple의 Swift Migrator	Apple이 승인한 마이그레이션을 원할 때	덜 인터랙티브; 프로젝트 인식이 낮음
twostraws SwiftUI Agent Skill	SwiftUI 전용 포커스	다른 의견

Axiom (xOS Dev Skills)