/accessibility-review
見慣れないプレースホルダーがある場合や、どのツールが接続されているかを確認する必要がある場合は、CONNECTORS.md を参照してください。
デザインまたはページに対してWCAG 2.1 AAアクセシビリティ準拠の監査を実行します。
使用方法
/accessibility-review $ARGUMENTS
アクセシビリティ監査を実行: @$1
WCAG 2.1 AA クイックリファレンス
知覚可能
- 1.1.1 非テキストコンテンツには代替テキストを付与する
- 1.3.1 情報と構造は意味的に伝える
- 1.4.3 コントラスト比 >= 4.5:1(標準テキスト)、>= 3:1(大きいテキスト)
- 1.4.11 非テキストのコントラスト >= 3:1(UIコンポーネント、グラフィック)
操作可能
- 2.1.1 すべての機能はキーボードで操作可能
- 2.4.3 論理的なフォーカス順序
- 2.4.7 可視フォーカスインジケーター
- 2.5.5 タッチターゲット >= 44x44 CSSピクセル
理解可能
- 3.2.1 フォーカス時に予測可能(予期しない変更をしない)
- 3.3.1 エラー識別(エラー内容を説明する)
- 3.3.2 入力にはラベルまたは説明を付ける
堅牢
- 4.1.2 すべてのUIコンポーネントで名前、役割、値を指定する
一般的な問題
- 不十分な色のコントラスト
- フォームラベルの欠落
- インタラクティブ要素へのキーボードアクセスがない
- 意味のある画像に代替テキストがない
- モーダル内のフォーカストラップ
- 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 | 矢印キー |
|------|----------|-------------|--------|----------|
| [要素] | [順序] | [動作] | [動作] | [動作] |
### スクリーンリーダー
| 要素 | 読み上げ内容 | 問題 |
|------|-------------|------|
| [要素] | [SRの読み上げ] | [問題があれば] |
### 優先修正項目
1. **[重大な修正]** — [誰]に影響し、[何]をブロックします
2. **[主要な修正]** — [何]を改善し、[誰]にとって
3. **[軽微な修正]** — あれば便利
コネクタが利用可能な場合
~~デザインツール が接続されている場合:
- Figmaから色の値、フォントサイズ、タッチターゲットを直接検査
- デザイン仕様書でコンポーネントのARIAロールとキーボード動作を確認
~~プロジェクト管理ツール が接続されている場合:
- アクセシビリティの各所見について、重大度とWCAG基準を含むチケットを作成
- 既存のアクセシビリティ改善エピックに所見をリンク
ヒント
- コントラストとキーボードから始める — これらが最も一般的で影響の大きい問題を捉えます。
- 実際の支援技術でテストする — 私の監査は素晴らしい出発点ですが、VoiceOver/NVDAを使った手動テストで私には見つけられない問題を発見できます。
- 影響度で優先順位をつける — ユーザーをブロックする問題を最初に修正し、後で細かい修正を行います。