justinwetch/HIGAgentSkills
Apple Human Interface Guidelines for Agents
그것이 무엇인가
apple-hig는 대화형 AI 에이전트용 스킬 (플러그인)로, 에이전트가 Apple 휴먼 인터페이스 가이드라인(HIG)에 대한 질문에 답할 수 있게 합니다. 저장소에는 약 26.2만 단어에서 약 9만 단어로 줄인 157개의 HIG 참조(소스 검토됨)와 새로운 폴더블 iPhone Duo(iOS 27)에 기존 앱을 적응시키는 과정을 안내하는 특수 /duo 슬래시 명령이 포함되어 있습니다. 이 스킬에는 기계 학습 모델이 포함되어 있지 않으며, 단지 선별된 텍스트와 호스트 에이전트가 호출할 수 있는 결정적 워크플로를 제공합니다.
핵심 기능
| 기능 | 설명 |
|---|---|
| HIG 참조 코퍼스 | 157개의 주제 파일(references/hig/*.md)로, Apple 공식 가이드라인의 정확한 표현, 값, 조건을 포함하며, 충실도를 유지하면서 훨씬 짧게 다시 작성되었습니다. |
| /duo 명령 | 다단계 워크플로(commands/duo.md): 1️⃣ 코드에서 앱의 화면을 평가하고, 2️⃣ Apple의 Duo 지침과 일치시키고, 3️⃣ SwiftUI 미리보기와 함께 옵션을 제시하고, 4️⃣ 필요한 SwiftUI/UIKit 변경을 생성하고, 5️⃣ iPhone Duo 시뮬레이터에서 검증합니다. |
| 강제 모드(선택 사항) | 요청 시 스킬은 두 명의 독립 검토자가 UI를 점수화하는 '검토 및 수리' 루프를 실행할 수 있습니다(90/100 통과 필요). 최대 3주기까지 반복하며, 호스트가 필요한 하위 에이전트와 아티팩트 액세스를 제공하면 문제를 자동으로 수정합니다. |
| 라우팅 헬퍼 | 작은 Python 스크립트(scripts/hig_route.py)로, 리터럴 일치에 따라 사용자 요청을 적절한 참조 파일에 매핑하여 토큰 부하를 낮게 유지합니다. |
| 패키징 | 결정적 ZIP 빌더(scripts/package_runtime_zip.py)가 필요한 파일만 포함하는 런타임 번들(SKILL.md, routing-index.md, references/, commands/)을 생성합니다. |
설치 방법
- 복사-붙여넣기 프롬프트 – 제공된 텍스트 블록을 AI 에이전트의 채팅에 붙여넣습니다. 에이전트는 저장소를 복제하고,
apple-hig/폴더를 스킬 디렉토리에 배치하고,/duo명령을 등록합니다. - 수동 설치 – ZIP을 다운로드하고,
apple-hig/폴더 전체를 에이전트의 스킬 위치에 추출하고,SKILL.md와commands/폴더가 있는지 확인합니다. - 슬래시 명령 등록 – 일부 에이전트는
commands/duo.md를 자동 감지하지만, 다른 에이전트는 해당 파일을 에이전트의 사용자 정의 슬래시 명령 디렉토리에 복사하고 호스트를 다시 시작해야 합니다. - 검증 – 에이전트에게 스킬을 찾아 버전(2026-09-27)과
/duo사용 가능 여부를 보고하도록 요청합니다.
일반적인 사용법
apple-hig를 사용하여 이 iOS 앱의 내비게이션과 접근성을 검토하세요.
에이전트는 관련 기본 파일, 플랫폼별 HIG 섹션 및 1홉 관련 지침을 로드한 다음 소스 조항의 직접 인용과 간결한 권장 사항으로 답변합니다.
Duo 워크플로 예시
/duo 라이브러리 및 읽기 흐름
명령은 개발자를 다음과 같이 안내합니다:
- 평가 – 앱의 SwiftUI/Storyboard 파일을 스캔합니다.
- 일치 – 각 화면을 Duo 체크리스트와 비교합니다.
- 결정 – SwiftUI 미리보기 옵션을 표시하고 확인을 요청합니다.
- 빌드 – 필요한 코드 변경을 작성합니다.
- 검증 – iPhone Duo 시뮬레이터에서 앱을 실행합니다(가능한 경우).
프로젝트에
duo-notes.md파일이 유지되어 나중에/duo continue가 중단된 지점에서 계속할 수 있습니다.
강제 모드 예시
apple-hig를 강제 모드로 사용하여 이 인터페이스를 검토하고 수정하세요.
스킬은 두 개의 검토 하위 에이전트를 생성하고, UI를 점수화하고, 수정을 적용하고, 통과 임계값에 도달하거나 3주기가 소진될 때까지 반복합니다.
기술 요구 사항
- Python 3.10+ – 라우팅 헬퍼 및 강제 모드 점수화에 필요합니다.
- 특별한 하드웨어는 필요 없으며, 일반 텍스트 마크다운 파일을 읽을 수 있는 모든 호스트에서 작동합니다.
- 에이전트는 사용자 정의 슬래시 명령을 지원하거나 스킬 디렉토리에서 파일을 로드할 수 있어야 합니다.
라이선스 및 귀속
- 코드와 선별된 참조 파일은 MIT 라이선스로 배포됩니다.
- 기반 Apple HIG 자료는 Apple의 자산이며, 저장소에는 프로젝트가 Apple과 제휴하지 않음을 명시하는
NOTICE파일이 포함되어 있습니다.
이 요약은 저장소의 README에만 기반하며, 추가 기능은 추론되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트