ui-review 가이드

한 줄 결과물: 9개 차원을 0~3점으로 채점한 표, 차단 조건 7가지 확인 결과, 판정(통과 / 수정 후 통과 / 실패)과 수정안.

언제 쓰나

사람이나 에이전트가 만든 화면, 컴포넌트, 브랜치, 실행 중인 URL을 머지나 전달 전에 검수할 때
"이 화면 괜찮아?", "UI 리뷰", "디자인 QA" 요청
쓰지 않을 때: 정식 WCAG 적합성 판정(a11y-audit), 슬라이드 덱(deck-qa), 취향 평가(design-critique)

UI 리뷰 결과: 9차원 점수 막대, 데스크톱/모바일 스크린샷, 수정안

입력	값
범위	대시보드 목록 화면, 과업은 보류 요청 확인
렌더	데스크톱 1440px, 모바일 390px 두 장
점수	목적과 카피 2, 시스템 준수 3, 레이아웃 2, 상태 1, 인터랙션 2, 접근성 2, 모션 2, 성능 3, 코드 위생 2
판정	평균 2.3(= 21/9), 차단 0건이므로 "수정 후 통과"(2.0~2.4)
수정안	상태 1점: 목록 비어 있음 화면이 없다. 빈 상태와 다음 행동을 추가한다

점수와 화면은 모양을 보여 주는 예시다. 실제로는 모든 점수에 파일과 줄, 또는 스크린샷 위치를 근거로 단다.

범위를 한 줄로 쓴다. 대상, 사용자 과업, 끝났다고 볼 기준.

ui-review 스킬로 <URL 또는 브랜치> 를 검수해 줘.
과업: 보류 중인 요청을 확인하고 승인한다. 코드는 고치지 말고 판정과 수정안만 줘.

기계가 볼 수 있는 것부터 찾는다.

grep -rnE "#[0-9a-fA-F]{6}|transition:\s*all|<div[^>]*onClick" src/

차단 조건 7가지를 확인한다. 하나라도 있으면 점수와 무관하게 실패다(접근성 치명 위반, 키보드로 핵심 작업 불가, 시스템에 없는 값 하드코딩, 비어 있음/오류 상태 없음, 스크린샷 없이 확인했다고 보고, 프로토타입 코드가 프로덕션 경로에서 쓰임, 레이아웃 속성 애니메이션이나 transition: all).
9개 차원을 0~3점으로 채점한다. 0 불가, 1 부족, 2 통과, 3 탁월. N/A는 평균에서 뺀다.
반증한다. 각 지적이 제품의 의도된 선택인지, 근거 문서가 허용하는지 확인하고 살아남은 것만 남긴다. 확신이 낮으면 "확인 필요"로 분리한다.
판정한다. 평균 2.5 이상이고 차단 0이면 통과, 2.0~2.4이면 수정 후 통과, 그 외 실패.