hig-components-menus

hig-components-menus 스킬 개요

hig-components-menus는 Apple 플랫폼 전반에서 메뉴와 버튼 기반 명령 표면을 설계할 때 참고하는 Apple HIG 가이드 스킬입니다. 메뉴, 컨텍스트 메뉴, Dock 메뉴, 편집 메뉴, 메뉴 막대, 툴바, 액션 버튼, 팝업 버튼, 풀다운 버튼, 펼침 제어, 표준 버튼에 대해 실용적인 방향이 필요할 때 hig-components-menus 스킬을 사용하세요.

이 스킬은 UI 디자이너, 프로덕트 디자이너, 프론트엔드 엔지니어, 그리고 Apple 스타일 인터페이스 가이드를 생성하는 AI 에이전트에게 특히 잘 맞습니다. 핵심 과제는 단순히 “메뉴가 무엇인가?”가 아니라 “여기에 어떤 컨트롤이 들어가야 하고, 무엇을 담아야 하며, Apple 관례에 맞고 예측 가능하게 동작하려면 어떻게 해야 하는가?”입니다.

무엇을 판단하는 데 도움이 되는가

hig-components-menus 가이드는 디자인 질문이 시각적 마감보다 명령 배치에 더 가깝다고 판단될 때 유용합니다. 툴바 액션, 메뉴 막대 명령, 컨텍스트 메뉴, 인라인 컨트롤 사이에서 선택하도록 돕고, 가치가 낮은 항목으로 메뉴가 비대해지는 것을 막아 주며, 레이블·순서·그룹화를 플랫폼 기대치에 맞게 정리하는 데 도움이 됩니다.

설치할 가치가 있는 이유

일반적인 프롬프트와 비교하면 hig-components-menus는 구조화된 HIG 범위와 함께 버튼, 컨텍스트 메뉴, 편집 메뉴, 툴바 같은 인접 주제로의 상호 참조를 제공합니다. 그래서 컴포넌트 경계와 동작에 따라 판단해야 하는 상황, 특히 폭넓은 UI 조언이 아니라 Apple 고유의 일관성이 필요한 경우에 더 강합니다.

가장 잘 맞는 경우와 맞지 않는 경우

Apple 플랫폼용으로 디자인하거나 제품 의도를 Apple HIG에 맞는 UI로 번역하고 있다면 hig-components-menus를 설치하세요. 프레임워크 코드, 컴포넌트 구현 세부사항, 비Apple 디자인 시스템이 필요하다면 이 스킬은 건너뛰는 편이 맞습니다. 이 스킬은 SDK API가 아니라 디자인 가이드와 상호작용 선택에 초점이 있습니다.

hig-components-menus 스킬 사용 방법

설치하고 올바른 진입 파일을 여세요

디렉터리에서 hig-components-menus 설치 경로를 사용한 다음 SKILL.md부터 시작하세요. 가장 도움이 되는 보조 파일은 references/ 페이지입니다. 주요 컴포넌트 계열을 읽기 쉬운 단위로 나눠 놓았기 때문입니다. 빠르게 확인하려면 먼저 references/menus.md, references/buttons.md, references/context-menus.md, references/toolbars.md를 읽으세요.

구체적인 UI 문제를 스킬에 전달하세요

hig-components-menus는 추상적인 디자인 조언을 요청하기보다 화면, 플랫폼, 사용자 목표를 함께 설명할 때 가장 잘 작동합니다. 좋은 입력에는 명령의 출처, 문맥, 제약이 들어갑니다.

• “8개의 자주 쓰는 작업과 12개의 가끔 쓰는 작업이 있는 macOS 문서 편집기의 명령 표면을 설계해 주세요.”
• “iPadOS에서는 삭제, 복제, 공유를 툴바, 컨텍스트 메뉴, 메뉴 막대 중 어디에 두는 게 좋을까요?”
• “선택한 텍스트와 파일 항목에 대해 Apple 스타일 컨텍스트 메뉴는 어떻게 달라져야 하나요?”

그냥 “내 메뉴를 디자인해 줘”라고만 하면, 스킬이 상호작용 모델을 추측해야 하므로 유용성이 떨어집니다.

판단 순서대로 참조 파일을 읽으세요

실용적인 hig-components-menus 가이드는 보통 메인 컴포넌트에서 시작해 특수 사례로 좁혀 갑니다. 레이블과 구성 규칙은 references/menus.md, 관련성과 항목 수는 references/context-menus.md, 항상 보이게 해야 할 항목을 판단할 때는 references/toolbars.md를 읽으세요. macOS의 명령 구조는 references/the-menu-bar.md, 텍스트 편집이 포함될 때는 references/edit-menus.md를 사용하면 됩니다.

결정 우선 워크플로를 사용하세요

먼저 스킬에 컨트롤 선택을 묻고, 그다음 내용, 마지막으로 순서를 묻는 방식이 좋습니다. 좋은 프롬프트 형식은 다음과 같습니다.

1. 플랫폼: macOS, iPadOS, iOS, 또는 visionOS
2. 대상: 선택 영역, 문서, 메시지, 파일, 또는 앱 전역 명령
3. 액션 집합: 기본, 보조, 파괴적, 사용 불가 액션
4. 제약: 공간, 발견성, 키보드 지원, 또는 일관성

이 구조는 hig-components-menus 스킬이 명령이 어디에 속해야 하는지, 무엇을 숨기거나 묶거나 앞세워야 하는지에 대해 더 정확하게 답하도록 도와줍니다.

hig-components-menus 스킬 FAQ

hig-components-menus는 메뉴만 다루나요?

아닙니다. hig-components-menus 스킬은 메뉴뿐 아니라 명령 접근을 제어하는 인접 버튼 패턴도 다룹니다. 액션 버튼, 팝업 버튼, 풀다운 버튼, 펼침 제어, 툴바, 표준 버튼이 모두 포함됩니다. 이런 넓은 범위가 유용한 이유는 Apple UI 의사결정에서 어떤 액션을 버튼으로 노출할지, 메뉴 항목으로 둘지, 혹은 둘 다로 둘지가 중요한 경우가 많기 때문입니다.

언제 이 스킬을 쓰지 말아야 하나요?

질문이 주로 시각적 브랜딩, 커스텀 모션, 컴포넌트 코드에 관한 것이라면 hig-components-menus를 쓰지 마세요. Apple 생태계가 아니고 Apple HIG 동작이 필요하지 않은 경우에도 적합하지 않습니다. 구현 세부사항이 필요하다면 프레임워크 문서와 함께 사용하는 편이 좋습니다.

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

일반 프롬프트는 메뉴 구조를 제안할 수 있지만, hig-components-menus 스킬은 Apple 고유의 트레이드오프, 즉 명령 계층, 플랫폼 관례, 메뉴 밀도, 보이는 액션과 숨겨진 액션 중 무엇을 우선할지에 맞춰져 있습니다. 그래서 Apple 기기에서 자연스럽게 느껴지는 UI가 필요할 때 추측을 줄이는 데 도움이 됩니다.

초보자도 사용하기 쉬운가요?

네, 화면과 그 안의 액션을 설명할 수 있다면 충분합니다. hig-components-menus를 시작하는 데 깊은 HIG 지식은 필요하지 않지만, 사용자가 무엇을 하고 있는지와 어떤 명령이 가능한지 알려 줄 정도의 문맥은 있어야 합니다. 시나리오가 구체적일수록 안내도 더 좋아집니다.

hig-components-menus 스킬을 개선하는 방법

목표만 말하지 말고 액션 목록을 제공하세요

품질을 가장 크게 끌어올리는 방법은 실제 액션을 나열하는 것입니다. “더 쉽게 만들어 주세요”라고만 하지 말고, 명령 집합을 제시한 뒤 어떤 액션이 자주 쓰이는지, 드문지, 파괴적인지, 문맥적인지 표시하세요. 그래야 hig-components-menus가 툴바, 메뉴, 컨텍스트 메뉴 중 무엇이 적절한지, 그리고 어떤 항목을 숨기거나 노출해야 하는지를 판단할 수 있습니다.

플랫폼과 트리거를 명시하세요

macOS에 맞는 메뉴 패턴이 iOS나 iPadOS에서는 맞지 않을 수 있습니다. 사용자가 클릭, 오른쪽 클릭, 길게 누르기, 키보드, 메뉴 막대 탐색 중 어떤 방식으로 명령을 호출하는지 분명히 적으세요. hig-components-menus 가이드는 플랫폼별 상호작용 경로에 민감하며, 특히 컨텍스트 메뉴와 편집 메뉴에서 그 차이가 큽니다.

최종 답만 묻지 말고 트레이드오프를 물어보세요

첫 답이 너무 일반적이라면, 왜 어떤 명령이 다른 위치보다 그곳에 있어야 하는지 다시 질문하세요. 예를 들어 “컨텍스트 메뉴에 있는 항목 중 어떤 것을 툴바로 옮겨야 하고, 그때 발견성 비용은 무엇인가요?”처럼요. 이렇게 물으면 hig-components-menus 활용도가 높아집니다. 출력이 단순한 목록이 아니라 의사결정을 돕는 자료가 되기 때문입니다.

흔한 실패 모드를 점검하세요

대표적인 실수는 너무 많은 항목이 들어간 메뉴, 우선순위 없이 중복된 명령, 핵심 액션을 보조 제스처 뒤에 숨기는 것입니다. 이런 문제를 초기에 점검하는 데 이 스킬을 활용하세요. 첫 결과가 지나치게 빽빽해 보인다면, 가치가 높은 항목만 줄여 달라고 하거나 기본 액션과 보조 액션을 더 엄격하게 분리해 달라고 요청하세요.