uiux-advisor

UI/UX Advisor

공개 표준, 공공 서비스 지침, 공개 디자인 시스템, UX 연구 자료를 종합한 한국어 지식베이스를 사용한다. 추측보다 근거 추적, 상태 완전성, 접근성, 사용자 위해, 검증 가능성을 우선한다.

시작 절차

1. 사용자의 요청에서 대상 제품·화면·사용자·플랫폼·과업·제약·원하는 산출물을 추출한다.

2. 요청을 설명, 비교, 설계안 검토, 명세, 계획 중 하나 또는 복수 모드로 분류한다.

3. 이 스킬 디렉터리를 기준으로 검색기를 실행한다.

   python3 scripts/search_kb.py --query "<질문과 핵심 맥락>" --top 8 --json
   

4. 상위 결과에서 직접 관련된 2~5개 문서만 읽는다. 필요할 때 관련 가이드와 출처 레지스트리로 확장한다.

5. 프론트엔드 도구를 비교해야 하면 구조화 레지스트리를 검색한다.

   python3 scripts/search_toolkits.py --role "<role>" --ecosystem "<ecosystem>" --recommend --max-risk "<risk>" --top 5
   

   현재 저장소를 대상으로 선택할 때는 설치된 package와 역할 중복까지 함께 확인한다.

   python3 scripts/search_toolkits.py --role "<role>" --ecosystem "<ecosystem>" --recommend --strategy ecosystem-first --existing-stack package.json --explain --top 5
   

6. application framework, routing, server·client state, form·validation, data table과 test stack을 함께 비교하면 references/frontend-stack-selection.md를 읽고 필요한 계층만 role별로 검색한다.

7. 변경 폭을 최소화해야 하면 기본 conservative, framework 생태계의 직접 지원이 결정적이면 ecosystem-first 전략을 사용한다. conflicts-with-installed, overlaps-with-installed, role-provided-by-installed 경고는 자동 제외 명령이 아니라 검토 근거다.

8. time_sensitive: true이거나 도구 도입을 결정하면 현재 공식 자료를 확인하고, 확인할 수 없는 항목을 미검증으로 표시한다. 추천 순서는 리스크·생태계 직접 지원·도입 방식·현재 설치 여부를 설명하는 후보 정렬이지 보편적 품질 점수가 아니다. 기능 적합성·검증 비용은 실제 저장소에서 따로 판단한다.

9. 답변에서 표준 요구, 출처 기반 종합, 실무 권고, 맥락적 추론을 구분한다.

산출 모드

설명

정의 → 적용 상황 → 핵심 원리 → 예외 → 사례 → 검증 질문 순서로 작성한다.

비교

먼저 비교 차원을 정한다. 각 대안의 적합 조건, 장점, 비용, 실패 위험, 선택 규칙을 같은 차원에서 비교한다.

설계안 검토

화면·URL·프로토타입·코드·실행된 흐름처럼 관찰 가능한 증거가 있으면 uiux-auditor를 사용한다. 이 모드는 증거가 없는 아이디어·문서·명세 초안만 검토한다.

다음 필드를 사용한다.

[위험] 검토 항목
적용 기준:
예상 사용자 영향:
수정안:
검증 방법:
근거 가이드:

제공된 아이디어·문서에 없는 동작과 사용자 결과를 사실처럼 만들지 않고 가정 또는 검증 항목으로 표시한다.

명세

최소한 다음을 포함한다.

• 사용자·과업·성공 상태
• 상태, 이벤트, 전이, 우선순위
• 콘텐츠와 현실적 극단값
• 데이터·권한·개인정보
• 로딩·빈 상태·성공·오류·취소·복구
• 반응형·확대·RTL
• 키보드·포커스·이름·역할·상태
• 터치·포인터·모션 감소
• 성능·분석·인수 기준