wcag-audit-patterns について
WCAG 2.2に基づいてウェブアクセシビリティを監査するチーム向けの実践ガイドです。適合レベルや一般的な問題を整理し、修正につながる実装指針を示します。
主な機能
- 01WCAGの適合レベル
- 02POURの原則
- 03影響度別の一般的な問題
- 04実行可能な修正ガイダンス
- 05手動・自動テストの実践
活用シーン
- 01ウェブサイトのアクセシビリティ監査
- 02WCAG違反の修正優先度付け
- 03アクセシブルなコンポーネントの構築
- 04ADA、Section 508、VPATへの対応準備
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wshobson/ agents --skill wcag-audit-patternsインストール後、Claude Code で/wcag-audit-patternsを入力して読み込まれたか確認します。
同梱ファイルreferences/details.md
詳細
WCAG 監査パターン
WCAG 2.2 ガイドラインに照らして Web コンテンツを監査し、実行可能な修正戦略を提示するための包括的なガイドです。
このスキルを使用する場面
- アクセシビリティ監査を実施する
- WCAG 違反を修正する
- アクセシブルなコンポーネントを実装する
- アクセシビリティ訴訟に備える
- ADA/Section 508 の要件を満たす
- VPAT 準拠を達成する
中核となる概念
1. WCAG 準拠レベル
| レベル | 説明 | 必要な場面 |
|---|---|---|
| A | 最低限のアクセシビリティ | 法的な基準ライン |
| AA | 標準的な準拠 | ほとんどの規制 |
| AAA | 強化されたアクセシビリティ | 特別なニーズ |
2. POUR 原則
Perceivable: Can users perceive the content?
Operable: Can users operate the interface?
Understandable: Can users understand the content?
Robust: Does it work with assistive tech?
3. 影響度別の一般的な違反
Critical (Blockers):
├── Missing alt text for functional images
├── No keyboard access to interactive elements
├── Missing form labels
└── Auto-playing media without controls
Serious:
├── Insufficient color contrast
├── Missing skip links
├── Inaccessible custom widgets
└── Missing page titles
Moderate:
├── Missing language attribute
├── Unclear link text
├── Missing landmarks
└── Improper heading hierarchy
詳細なパターンと実例
詳細なパターンのドキュメントは references/details.md にあります。上記のナビゲーション階層では不十分な場合は、そのファイルを参照してください。
ベストプラクティス
やるべきこと
- 早い段階から始める - 設計フェーズからアクセシビリティを考慮する
- 実際のユーザーでテストする - 障害のあるユーザーが最良のフィードバックを提供する
- 自動化できることは自動化する - 問題の 30~50% は検出可能
- セマンティック HTML を使用する - ARIA の必要性を減らす
- パターンを文書化する - アクセシブルなコンポーネントライブラリを構築する
避けるべきこと
- 自動テストだけに頼らない - 手動テストが必要
- ARIA を最初の解決策にしない - まずネイティブ HTML
- フォーカスアウトラインを隠さない - キーボードユーザーには必要
- ズームを無効にしない - ユーザーはサイズ変更する必要がある
- 色だけに頼らない - 複数の指標が必要
コメント
Markdown 対応