ios-design-guidelines

ios-design-guidelines 스킬 개요

ios-design-guidelines 스킬은 전체 원문을 먼저 다 읽지 않아도 iPhone UI 작업을 Apple Human Interface Guidelines에 맞춰 점검하고, 다듬고, 다시 쓰는 데 도움을 줍니다. SwiftUI와 UIKit 작업에서 특히 유용하며, 레이아웃, 내비게이션, 접근성, Dynamic Type, Dark Mode, 시스템 컴포넌트 선택이 결과를 좌우할 때 강점을 발휘합니다.

실제 인터페이스 결정을 내려야 할 때 이 ios-design-guidelines 스킬을 사용하세요. 추상적인 디자인 이론보다, 잘못된 HIG 실수를 빠르게 잡아내야 하는 디자이너, iOS 엔지니어, 리뷰 에이전트에 잘 맞습니다. 예를 들어 너무 작은 터치 타깃, 위험한 레이아웃, 비표준 내비게이션, 하드코딩된 글자 크기, 부족한 접근성 지원 같은 문제를 빠르게 걸러내는 데 유리합니다.

이 스킬이 가장 잘하는 일

핵심 역할은 대략적인 UI 아이디어를 iPhone에 적합한 구현안이나 리뷰 체크리스트로 바꾸는 것입니다. Apple 기준의 기본값, SwiftUI/UIKit 예시, 그리고 “직관적으로 만들라” 같은 추상 조언보다 구체적인 규칙 점검이 필요할 때 이 스킬이 가장 강합니다.

실제로 가치가 커지는 지점

탭 바와 커스텀 내비게이션, safe area 동작, 하단 고정 액션, 텍스트 스케일링, semantic color, 시스템 제스처처럼 흔한 iOS 패턴 사이에서 무엇을 선택할지 고민할 때 특히 유용합니다. 그래서 ios-design-guidelines 가이드는 저장소를 대충 훑어보는 것보다 훨씬 더 결정 중심적입니다.

맞지 않는 경우

제품 전략 전반, 크로스플랫폼 디자인 조언, Android/web 패턴이 필요하다면 이 스킬은 올바른 기준 소스가 아닙니다. iOS 관례와 무관한 순수 시각 브랜딩 작업에도 효과가 떨어집니다.

ios-design-guidelines 스킬 사용 방법

설치하고 필요한 파일부터 확인하기

npx skills add ehmo/platform-design-skills --skill ios-design-guidelines로 설치하세요. ios-design-guidelines 설치 효과를 제대로 보려면 먼저 SKILL.md를 읽고, 그다음 AGENTS.md, metadata.json, rules/_sections.md를 확인해야 합니다. 이 파일들에는 스킬의 범위, 규칙 우선순위, 그리고 실제로 가장 자주 적용하게 될 몇 가지 규칙 그룹이 들어 있습니다.

막연한 목표를 쓸모 있는 프롬프트로 바꾸기

ios-design-guidelines를 잘 쓰는 시작점은 구체적인 인터페이스 맥락입니다. 플랫폼, 화면 종류, 사용자 과업, 현재 리스크를 함께 넣으세요. 예를 들어 “이 SwiftUI 결제 화면을 iPhone 기준으로 검토해 주세요. thumb-zone 배치, safe area, 터치 타깃, Dynamic Type에 집중하고, 현재 흐름은 유지하는 선에서만 수정안을 제안해 주세요.”처럼 요청하면 됩니다. 이렇게 해야 스킬이 “앱을 개선해 주세요” 같은 포괄적 요청이 아니라 실행 가능한 작업으로 받아들입니다.

출력 품질을 높이는 입력 방식

관련 UI 발췌, 구성 요소 목록, 제약 조건을 함께 주세요. iPhone 전용인지 범용인지, SwiftUI인지 UIKit인지, 지원하는 iOS 버전은 무엇인지, 반드시 유지해야 하는 동작은 무엇인지 명시하세요. 리라이트를 요청한다면 현재 코드나 화면 구조도 같이 넣어야 스킬이 추측하지 않고 실제 컨트롤에 규칙을 매핑할 수 있습니다.

따라야 할 실무 워크플로

먼저 범위를 좁힌 1차 리뷰를 받고, 그다음 위험도가 높은 영역—내비게이션, 접근성, 레이아웃—만 따로 두 번째로 점검하세요. 예를 들어 먼저 가장 우선순위가 높은 HIG 위반을 물은 뒤, 상위 3개 문제에 대해서만 수정된 구현을 요청하는 방식입니다. 이렇게 하면 ios-design-guidelines 사용이 효율적이고, 수정도 적용하기 쉬워집니다.

ios-design-guidelines 스킬 FAQ

이건 SwiftUI 전용인가요?

아닙니다. ios-design-guidelines 스킬은 SwiftUI와 UIKit 모두를 다룹니다. 그래서 새로 만드는 앱과 기존 코드 리팩터링 모두에 사용할 수 있습니다. 코드를 생성하는 용도만이 아니라, 구현 선택이 iPhone 관례와 맞는지 비교하는 데 쓰세요.

일반 프롬프트와 무엇이 다른가요?

일반 프롬프트는 표면적인 UI 조언만 내놓는 경우가 많습니다. 이 스킬은 Apple 전용 규칙과 흔한 실패 패턴을 중심으로 설계되어 있어서, 검토 가능한 iPhone 네이티브 권장안을 더 적은 추측으로 얻고 싶을 때 더 적합합니다.

iOS 전문가가 아니어도 쓸 수 있나요?

네. 화면을 명확하게 설명하고 이미 가진 코드나 레이아웃을 함께 주면 초보자도 충분히 잘 사용할 수 있습니다. 가장 큰 한계는 입력 품질입니다. 프롬프트가 모호하면 결과도 모호해집니다.

언제 사용을 피해야 하나요?

iPhone이 아닌 인터페이스, 브랜드용 목업, 또는 표준 iOS 동작을 의도적으로 깨고 싶은 경우에는 건너뛰세요. 새로운 인터랙션 패턴이 목표라면 ios-design-guidelines 스킬이 오히려 시스템 관례로 되돌리려 할 수 있습니다.

ios-design-guidelines 스킬 개선 방법

스킬에 필요한 규칙 맥락을 주기

가장 좋은 결과는 어떤 부분이 HIG 검토에서 실패하기 쉬운지 명확히 알려줄 때 나옵니다. 레이아웃, 내비게이션, 타이포그래피, 색상, 접근성 중 무엇이 가장 중요한지 말해 주면 ios-design-guidelines 스킬이 피드백의 무게중심을 제대로 잡을 수 있고, 주의를 너무 넓게 분산하지 않아도 됩니다.

설명만 말고 변경을 요청하기

구현 도움을 원한다면 수정된 화면 구조, 고쳐진 SwiftUI/UIKit 코드, 또는 우선순위가 매겨진 수정 목록을 요청하세요. 이 스킬은 문제를 명시적인 작업으로 바꿀 수 있을 때 더 유용합니다. 예를 들어 터치 타깃을 키우기, 주요 액션을 thumb zone으로 옮기기, safe area 준수를 복원하기 같은 식입니다.

자주 놓치는 실패 모드 살피기

가장 큰 실수는 대체로 iOS와 충돌하는 커스텀 내비게이션, 스케일되지 않는 텍스트, 접근성에서 실패하는 시각 전용 상태 표시입니다. 첫 답변이 너무 일반적이라면 “현재 내비게이션은 유지해야 함” 또는 “extra-large Dynamic Type을 지원해야 함” 같은 구체적인 제약을 추가해 ios-design-guidelines 사용을 더 날카롭게 만드세요.

두 번째 프롬프트는 더 좁게 다시 돌리기

첫 답변 이후에는 전체 리뷰를 다시 묻기보다 가장 중요한 리스크 영역만 다시 점검하세요. 예를 들어 “이제 VoiceOver, Reduce Motion, 대비만 접근성 관점에서 확인해 주세요.”라고 요청하면 더 날카로운 피드백을 얻을 수 있고, 실제 프로젝트에서 ios-design-guidelines 설치 가치를 더 높일 수 있습니다.