인터페이스 감수성은(는) 무엇을 하나요?
인터페이스가 어떻게 움직이고 반응하는지에 대한 마스터 패스입니다. 현재 앱이 무엇을 하는지 40가지 항목(12가지 애니메이션 원칙, 8가지 UX 법칙, 20가지 UI 기법)과 모션 시스템을 기준으로 감사하고, 보고서를 작성한 후, 각 항목의 패턴에 따라 발견된 문제를 수정합니다. 대부분의 앱은 이미 목록의 절반을 갖추고 있습니다. 감사는 이를 파악하여 중복으로 추가하지 않습니다. 속도, 타겟, 신뢰성이 항상 적용되며, 장식은 업무 도구에서 제한적으로 사용됩니다.
프로젝트 자체 디자인 시스템, 모션 토큰 및 규칙이 여기의 모든 것보다 우선합니다. 성능 예산(LCP, INP, 번들 크기), 접근성, 카피는 이 패스와 별도로 진행됩니다.
이 스킬의 파일
| 파일 | 용도 |
|---|---|
reference.md | 40가지 항목 각각: 확인 방법, 수정 패턴, 건너뛰어야 할 때, 실제 감사에서 발견된 사항 |
motion.md | 모션 시스템: 토큰, 12가지 규칙, CSS 패턴, 모션 감사 방법 |
audit/census.sh | 코드 센서스: 각 항목 뒤에 있는 패턴을 파일:줄 위치와 함께 집계 |
audit/probe.js | 라이브 페이지 프로브: 실제 히트 타겟, 지속 시간, 이징, 수치, 제목, 코드 필드, 플레이스홀더 |
report-template.md | 감사 보고서: 항목별 판정 행, 작업 순서, 확인되지 않은 사항 |
패스 1: 감사 (아무것도 변경하지 않음)
- 프로젝트의 디자인 시스템, 모션 토큰 및 UI 규칙을 먼저 읽습니다.
- 프로젝트 루트에서 센서스를 실행합니다:
bash <이 스킬>/audit/census.sh . --show 5. 배포된 표면만 읽습니다(의존성, 빌드, 벤더 복사본, 테스트, 벤치마크, 생성된 파일 및 주석 줄은 제외; 더 추가하려면CENSUS_EXCLUDE="dir1,dir2"사용). 빠른 실행을 위해 ripgrep을 설치하세요. 없으면 스크립트가 perl로 대체됩니다. 개수는 판정이 아닌 열어볼 단서입니다. - 앱을 실행합니다. 각 주요 페이지에서
audit/probe.js를 실행합니다(콘솔에 붙여넣거나 브라우저 도구의 JavaScript 실행기에서await사용), 1440 너비와 375 너비에서, 앱이 가진 각 테마별로. 한 번에 한 화면씩 페이지를 스크롤하고 위치를 복원합니다. 숨겨진 탭은 너비가 없고 프레임을 그리지 않습니다: 먼저 표시하세요. 출력을 판단하여 읽습니다:spaced로 표시된 타겟(다음 컨트롤과의 간격이 최소 기준에 도달)은 심각도가 낮습니다. 수치는 변경되는 곳에서만tabular-nums가 필요합니다. 장식용 모의 창은aria-hidden으로 표시하거나 해당 행을 무시합니다. - 어떤 스크립트도 볼 수 없는 것을 직접 손으로, 실제 포인터 이벤트(브라우저 도구의 클릭, 합성
.click()이 아님)로 테스트합니다: 각 유료 또는 취소 불가능한 작업을 두 번 빠르게 누르고 서버 효과를 셉니다. 네트워크와 쓰기를 600ms로 제한하고 누릅니다. 모든 레이어를 빠르게 열고 닫고, 나가는 중간에 다시 열며, 불투명도를 샘플링합니다(motion.md, "다시 열기 측정"). 닫히는 메뉴 내부를 누릅니다. 악센트가 있거나 대소문자가 다른 쿼리를 입력합니다. 호버 서브메뉴를 향해 대각선으로 이동합니다. 레이어가 열린 상태에서 Android 뒤로 가기 버튼을 누릅니다. 전화기 시트를 스와이프합니다. report-template.md에서 보고서를 작성합니다: 40개 행 모두, 각각 있음, 없음, 잘못됨 또는 건너뛰기와 이유, 증거(파일:줄 또는 숫자), 그리고 빌드 또는 선택으로 표시합니다. 수정하기 전에 보여줍니다.
패스 2: 체크리스트에 따라 수정
- 신뢰 우선: 항목 39와 요금이 두 배로 청구되거나 데이터가 손실될 수 있는 모든 것. 수정 전에 실패하는 테스트를 포함합니다.
- 빌드 항목은 새로운 모양 없이 동작을 변경합니다(히트 슬롭, 세이프 트라이앵글, 뒤로 가기 제스처, 악센트 접기, 단축키, 명령 메뉴 항목, 낙관적 쓰기, 스켈레톤, 모션 토큰, 가역 전환).
reference.md와motion.md의 패턴에 따라 프로젝트 자체 컴포넌트와 토큰을 통해 각각을 수정하고, 로직에 대한 테스트를 포함합니다. - 선택 항목은 모양이나 제품을 변경합니다(모서리, 흐림 플레이스홀더, 확인 대신 실행 취소, 오류 비트, 새 모션 비트, 뷰 전환). 각각을 두 테마 모두에서 규모 1로 전후 비교하여 번호를 매기고 분리 가능하게 만듭니다. 소유자가 선택한 것만 빌드합니다.
- 제거된 장식을 새로운 장식으로 대체하지 마십시오.
패스 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로 단계별 실행한 실제 흐름 하나에서 이음새가 보임 |
| B | UX 법칙 | |
| 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로 만듭니다. - 실행 취소, 모서리 또는 오류음을 엔지니어링 선택으로 취급. 이는 소유자에게 속합니다.
- 개발 서버나 백그라운드 탭에서 프리페치 또는 타이밍을 판단.