/accessibility-review
낯선 플레이스홀더를 보거나 연결된 도구를 확인해야 한다면 CONNECTORS.md를 참조하세요.
디자인 또는 페이지를 WCAG 2.1 AA 접근성 준수 여부에 대해 감사합니다.
사용법
/accessibility-review $ARGUMENTS
접근성 감사: @$1
WCAG 2.1 AA 빠른 참조
지각 가능성(Perceivable)
- 1.1.1 비텍스트 콘텐츠는 대체 텍스트가 있어야 함
- 1.3.1 정보와 구조는 의미적으로 전달되어야 함
- 1.4.3 대비 비율 >= 4.5:1 (일반 텍스트), >= 3:1 (큰 텍스트)
- 1.4.11 비텍스트 대비 >= 3:1 (UI 컴포넌트, 그래픽)
운용 가능성(Operable)
- 2.1.1 모든 기능은 키보드로 사용 가능해야 함
- 2.4.3 논리적인 포커스 순서
- 2.4.7 가시적인 포커스 표시기
- 2.5.5 터치 대상 >= 44x44 CSS 픽셀
이해 가능성(Understandable)
- 3.2.1 포커스 시 예측 가능 (예상치 못한 변경 없음)
- 3.3.1 오류 식별 (오류를 설명)
- 3.3.2 입력에 대한 레이블 또는 지침
견고성(Robust)
- 4.1.2 모든 UI 컴포넌트의 이름(name), 역할(role), 값(value)
일반적인 문제
- 색상 대비 부족
- 폼 레이블 누락
- 대화형 요소에 키보드 접근 불가
- 의미 있는 이미지에 대체 텍스트 누락
- 모달 내 포커스 트랩
- ARIA 랜드마크 누락
- 자동 재생 미디어에 제어 기능 없음
- 연장 옵션 없는 시간 제한
테스트 접근법
- 자동화 스캔 (약 30% 문제 발견)
- 키보드 전용 내비게이션
- 스크린 리더 테스트 (VoiceOver, NVDA)
- 색상 대비 확인
- 200% 확대 — 레이아웃이 깨지는가?
출력
## 접근성 감사: [디자인/페이지 이름]
**표준:** WCAG 2.1 AA | **날짜:** [날짜]
### 요약
**발견된 문제:** [X] | **심각:** [X] | **중요:** [X] | **경미:** [X]
### 발견 사항
#### 지각 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [1.4.3 대비] | 🔴 심각 | [수정] |
#### 운용 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [2.1.1 키보드] | 🟡 중요 | [수정] |
#### 이해 가능성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [3.3.2 레이블] | 🟢 경미 | [수정] |
#### 견고성
| # | 문제 | WCAG 기준 | 심각도 | 권장 사항 |
|---|------|-----------|--------|----------|
| 1 | [문제] | [4.1.2 이름, 역할, 값] | 🟡 중요 | [수정] |
### 색상 대비 확인
| 요소 | 전경색 | 배경색 | 비율 | 요구 비율 | 통과? |
|------|--------|--------|------|----------|-------|
| [본문 텍스트] | [색상] | [색상] | [X]:1 | 4.5:1 | ✅/❌ |
### 키보드 내비게이션
| 요소 | 탭 순서 | Enter/Space | Escape | 화살표 키 |
|------|---------|-------------|--------|----------|
| [요소] | [순서] | [동작] | [동작] | [동작] |
### 스크린 리더
| 요소 | 발화 내용 | 문제 |
|------|----------|------|
| [요소] | [스크린 리더가 말하는 내용] | [문제가 있다면] |
### 우선순위 수정
1. **[심각 수정]** — [누구에게] 영향을 미치며 [무엇을] 차단함
2. **[중요 수정]** — [누구에게] [무엇을] 개선함
3. **[경미 수정]** — 있으면 좋은 수준
연결된 도구가 있을 경우
~~디자인 도구가 연결된 경우:
- Figma에서 색상 값, 글꼴 크기, 터치 대상을 직접 검사
- 디자인 스펙에서 컴포넌트의 ARIA 역할과 키보드 동작 확인
~~프로젝트 트래커가 연결된 경우:
- 각 접근성 발견 사항에 대해 심각도와 WCAG 기준을 포함한 티켓 생성
- 발견 사항을 기존 접근성 개선 에픽에 연결
팁
- 대비와 키보드부터 시작하세요 — 가장 흔하고 영향력이 큰 문제를 잡을 수 있습니다.
- 실제 보조 기술로 테스트하세요 — 제 감사는 좋은 출발점이지만, VoiceOver/NVDA로 수동 테스트하면 제가 놓칠 수 있는 부분을 찾을 수 있습니다.
- 영향도에 따라 우선순위를 정하세요 — 사용자를 차단하는 문제를 먼저 고치고, 이후에 개선하세요.