Communitygithub.com

인터페이스 감수성

앱이나 사이트가 더 세련되고, 빠르며, 프리미엄처럼 느껴져야 할 때, UI 감각, 모션, 애니메이션, 전환, 상호작용 품질을 감사하거나 수정할 때, 또는 핏츠, 힉, 도허티, 낙관적 업데이트, 스켈레톤, 명령 메뉴, 실행 취소 토스트, 히트 슬롭, 세이프 트라이앵글, 뷰 전환과 같은 UX 법칙, 애니메이션 원칙, UI 팁을 웹 또는 모바일 프로젝트에 적용할 때 사용합니다.

인터페이스 감수성란 무엇인가요?

이 스킬은 앱이나 사이트의 인터페이스 감각과 반응성을 종합적으로 감사하고 개선하는 전문 도구입니다. 12가지 애니메이션 원칙, 8가지 UX 법칙, 20가지 UI 기법, 그리고 모션 시스템을 포함한 40가지 항목을 체크리스트로 제공하며, 현재 앱의 상태를 분석한 보고서를 작성하고 각 항목을 패턴에 따라 수정합니다. 이미 절반 이상의 항목을 준수하고 있는 앱은 '있음'으로 표시하여 중복 작업을 방지합니다. Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 속도, 타겟팅, 신뢰성 향상에 중점을 두고 장식은 제한적으로 적용합니다. 감사, 수정, 검증의 3단계로 구성되어 있으며, 코드 센서스와 라이브 페이지 프로브를 통해 객관적인 데이터를 수집하고, 프로젝트의 디자인 시스템과 모션 토큰을 최우선으로 존중합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/groseljgal/interface-feel/tree/HEAD

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

인터페이스 감수성은(는) 무엇을 하나요?

인터페이스가 어떻게 움직이고 반응하는지에 대한 마스터 패스입니다. 현재 앱이 무엇을 하는지 40가지 항목(12가지 애니메이션 원칙, 8가지 UX 법칙, 20가지 UI 기법)과 모션 시스템을 기준으로 감사하고, 보고서를 작성한 후, 각 항목의 패턴에 따라 발견된 문제를 수정합니다. 대부분의 앱은 이미 목록의 절반을 갖추고 있습니다. 감사는 이를 파악하여 중복으로 추가하지 않습니다. 속도, 타겟, 신뢰성이 항상 적용되며, 장식은 업무 도구에서 제한적으로 사용됩니다.

프로젝트 자체 디자인 시스템, 모션 토큰 및 규칙이 여기의 모든 것보다 우선합니다. 성능 예산(LCP, INP, 번들 크기), 접근성, 카피는 이 패스와 별도로 진행됩니다.

이 스킬의 파일

파일용도
reference.md40가지 항목 각각: 확인 방법, 수정 패턴, 건너뛰어야 할 때, 실제 감사에서 발견된 사항
motion.md모션 시스템: 토큰, 12가지 규칙, CSS 패턴, 모션 감사 방법
audit/census.sh코드 센서스: 각 항목 뒤에 있는 패턴을 파일:줄 위치와 함께 집계
audit/probe.js라이브 페이지 프로브: 실제 히트 타겟, 지속 시간, 이징, 수치, 제목, 코드 필드, 플레이스홀더
report-template.md감사 보고서: 항목별 판정 행, 작업 순서, 확인되지 않은 사항

패스 1: 감사 (아무것도 변경하지 않음)

  1. 프로젝트의 디자인 시스템, 모션 토큰 및 UI 규칙을 먼저 읽습니다.
  2. 프로젝트 루트에서 센서스를 실행합니다: bash <이 스킬>/audit/census.sh . --show 5. 배포된 표면만 읽습니다(의존성, 빌드, 벤더 복사본, 테스트, 벤치마크, 생성된 파일 및 주석 줄은 제외; 더 추가하려면 CENSUS_EXCLUDE="dir1,dir2" 사용). 빠른 실행을 위해 ripgrep을 설치하세요. 없으면 스크립트가 perl로 대체됩니다. 개수는 판정이 아닌 열어볼 단서입니다.
  3. 앱을 실행합니다. 각 주요 페이지에서 audit/probe.js를 실행합니다(콘솔에 붙여넣거나 브라우저 도구의 JavaScript 실행기에서 await 사용), 1440 너비와 375 너비에서, 앱이 가진 각 테마별로. 한 번에 한 화면씩 페이지를 스크롤하고 위치를 복원합니다. 숨겨진 탭은 너비가 없고 프레임을 그리지 않습니다: 먼저 표시하세요. 출력을 판단하여 읽습니다: spaced로 표시된 타겟(다음 컨트롤과의 간격이 최소 기준에 도달)은 심각도가 낮습니다. 수치는 변경되는 곳에서만 tabular-nums가 필요합니다. 장식용 모의 창은 aria-hidden으로 표시하거나 해당 행을 무시합니다.
  4. 어떤 스크립트도 볼 수 없는 것을 직접 손으로, 실제 포인터 이벤트(브라우저 도구의 클릭, 합성 .click()이 아님)로 테스트합니다: 각 유료 또는 취소 불가능한 작업을 두 번 빠르게 누르고 서버 효과를 셉니다. 네트워크와 쓰기를 600ms로 제한하고 누릅니다. 모든 레이어를 빠르게 열고 닫고, 나가는 중간에 다시 열며, 불투명도를 샘플링합니다(motion.md, "다시 열기 측정"). 닫히는 메뉴 내부를 누릅니다. 악센트가 있거나 대소문자가 다른 쿼리를 입력합니다. 호버 서브메뉴를 향해 대각선으로 이동합니다. 레이어가 열린 상태에서 Android 뒤로 가기 버튼을 누릅니다. 전화기 시트를 스와이프합니다.
  5. report-template.md에서 보고서를 작성합니다: 40개 행 모두, 각각 있음, 없음, 잘못됨 또는 건너뛰기와 이유, 증거(파일:줄 또는 숫자), 그리고 빌드 또는 선택으로 표시합니다. 수정하기 전에 보여줍니다.

패스 2: 체크리스트에 따라 수정

  1. 신뢰 우선: 항목 39와 요금이 두 배로 청구되거나 데이터가 손실될 수 있는 모든 것. 수정 전에 실패하는 테스트를 포함합니다.
  2. 빌드 항목은 새로운 모양 없이 동작을 변경합니다(히트 슬롭, 세이프 트라이앵글, 뒤로 가기 제스처, 악센트 접기, 단축키, 명령 메뉴 항목, 낙관적 쓰기, 스켈레톤, 모션 토큰, 가역 전환). reference.md와 motion.md의 패턴에 따라 프로젝트 자체 컴포넌트와 토큰을 통해 각각을 수정하고, 로직에 대한 테스트를 포함합니다.
  3. 선택 항목은 모양이나 제품을 변경합니다(모서리, 흐림 플레이스홀더, 확인 대신 실행 취소, 오류 비트, 새 모션 비트, 뷰 전환). 각각을 두 테마 모두에서 규모 1로 전후 비교하여 번호를 매기고 분리 가능하게 만듭니다. 소유자가 선택한 것만 빌드합니다.
  4. 제거된 장식을 새로운 장식으로 대체하지 마십시오.

패스 3: 검증

센서스와 프로브를 다시 실행하고 숫자를 보고서와 비교합니다. 수정된 모든 상호작용을 사용자가 하는 방식으로, 두 테마 모두에서, 그리고 전화기 너비에서 별도로 테스트합니다. 빌드, 테스트, 시각적 승인, 배포를 별도의 사실로 보고하고, 측정할 수 없었던 것(실제 물리적 전화기 없음, 프로덕션 빌드 없음)을 명시합니다.

체크리스트

번호는 reference.md 및 보고서와 일치합니다.

#항목실패 조건
A애니메이션 원칙 (motion.md)
1스쿼시 앤 스트레치랜딩 배지, 점 또는 노브가 멈춰 섬
2안티시페이션누름 상태가 한 프레임 내에 없음 (약 0.97 스케일, 약 100ms)
3스테이징열린 레이어가 기본적인 것을 불분명하게 만듦
4포즈 투 포즈바쁜 버튼, 레이블 또는 아이콘 교체가 너비나 내용에서 점프함
5팔로우 스루레이어의 콘텐츠가 컨테이너에 용접된 것처럼 도착함
6슬로우 인, 슬로우 아웃UI 모션에 linear 또는 기본 ease; 세 개 이상의 이징
7아크어떤 것이 직선으로 멀리 이동함
8세컨더리 액션완료된 작업에 확인하는 두 번째 비트가 없음
9스내피 타이밍UI 응답이 300ms 초과; 한 표면이 동료와 다름; 종료가 더 짧지 않음
10과장된 피드백잘못된 제출이 약간의 움직임만 보이고 색상 변화가 없음
11솔리드 드로잉그림자와 레이어가 빛과 깊이에 대해 일치하지 않음
12어필규모 1로 단계별 실행한 실제 흐름 하나에서 이음새가 보임
BUX 법칙
13핏츠데스크톱에서 32px 미만 또는 휴대폰에서 44px 미만의 실제 타겟
14더 큰 히트 영역그림을 확대하거나 형제 요소와 겹쳐서 키운 타겟
15힉하나의 메뉴 블록에 5개 이상의 항목
16밀러청크되지 않은 최상위 항목이 약 7개 이상
17도허티누름부터 다음 페인트까지 400ms 초과, 먼저 응답하는 것 없음
18포스텔쿼리의 악센트, 대소문자 또는 간격 변형이 아무것도 찾지 못함
19야콥패턴이 플랫폼과 다르게 동작함 (호버 서브메뉴, 뒤로 가기가 레이어를 닫음)
20사용 빈도일일 작업이 한 단계 또는 한 명령 이상 떨어져 있음
C속도 및 피드백
21스켈레톤 로더경로가 클릭 프레임에 빈 화면이나 스피너를 그림
22낙관적 업데이트저렴하고 되돌릴 수 있는 쓰기가 서버 응답까지 아무것도 표시하지 않음
23명령 메뉴목적지에 클릭으로는 도달할 수 있지만 타이핑으로는 도달할 수 없음
24단축키 힌트단축키가 있는 컨트롤이 툴팁에 단축키를 표시하지 않음
25실행 취소 토스트복원 가능한 삭제에 실행 취소가 없음 (소유자가 확인을 대체할지 결정)
26스테일-와일-리밸리데이트다시 방문한 페이지가 마지막 데이터를 그리는 대신 기다림
27사전 렌더링예상되는 다음 페이지가 의도 시점에 프리페치되지 않음 (프로덕션에서 판단)
28흐림 플레이스홀더로딩 중인 그림이 회색 상자임
29뷰 전환그리드에서 상세 페이지 열기에 공유 요소 모프가 없음
30스와이프하여 닫기전화기 시트나 서랍을 스와이프하여 닫을 수 없음
31중단 가능한 애니메이션종료 중 다시 열기가 처음부터 재생됨
D플랫폼 및 세부 사항
32예측 뒤로 가기레이어가 열린 상태에서 Android 뒤로 가기가 페이지를 떠남
33히트 슬롭작은 아이콘 컨트롤에 보이지 않는 타겟 확장이 없음
34세이프 에어리어 인셋하단 플로트가 viewport-fit=cover에서 env(safe-area-inset-*)를 무시함
35일회용 코드 자동 채우기코드 필드에 autocomplete="one-time-code" 및 inputmode="numeric"이 없음
36표 형식 숫자변경되는 숫자가 떨림 (tabular-nums 없음)
37균형 잡힌 제목짧은 여러 줄 제목이 고아 단어를 남김 (text-wrap: balance 없음)
38연속 모서리스퀴클 모서리가 고려되지 않음 (외관 결정: 벤치마크)
E신뢰
39멱등성 키유료 또는 취소 불가능한 작업을 두 번 빠르게 누르면 두 번의 서버 효과가 발생함
40세이프 트라이앵글호버 서브메뉴가 대각선 이동 시 닫힘

일반적인 실수

  • 이미 있는 것을 추가: 스켈레톤, 캐싱, 모션 토큰은 종종 이미 있습니다. 판정은 있음입니다.
  • 클라이언트 중복 제거를 금전 보호로 사용: 두 번의 클릭이 버튼을 비활성화하는 리렌더링 이전에 도착합니다. 서버에서 보호하고(조건부 업데이트, 결정적 키, 잠금) 누름을 ref에 보관합니다.
  • 타겟 대신 그림을 키움; 데스크톱 규칙이 휴대폰 최소 기준을 무시하면서 데스크톱 너비에서만 타겟을 확인.
  • 열기 및 닫기에 키프레임 사용: 되돌릴 수 없습니다. 상태 속성에 전환을 사용하고, 나가는 레이어를 inert로 만듭니다.
  • 실행 취소, 모서리 또는 오류음을 엔지니어링 선택으로 취급. 이는 소유자에게 속합니다.
  • 개발 서버나 백그라운드 탭에서 프리페치 또는 타이밍을 판단.

관련 스킬