mcpField
W
wcag-audit-patterns

wcag-audit-patterns

github.com/wshobsonテスト・品質41.9k12.7k 回インストール2 週間前に更新
リポジトリ

wcag-audit-patterns について

WCAG 2.2に基づいてウェブアクセシビリティを監査するチーム向けの実践ガイドです。適合レベルや一般的な問題を整理し、修正につながる実装指針を示します。

主な機能

  1. 01WCAGの適合レベル
  2. 02POURの原則
  3. 03影響度別の一般的な問題
  4. 04実行可能な修正ガイダンス
  5. 05手動・自動テストの実践

活用シーン

  1. 01ウェブサイトのアクセシビリティ監査
  2. 02WCAG違反の修正優先度付け
  3. 03アクセシブルなコンポーネントの構築
  4. 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
  • フォーカスアウトラインを隠さない - キーボードユーザーには必要
  • ズームを無効にしない - ユーザーはサイズ変更する必要がある
  • 色だけに頼らない - 複数の指標が必要

コメント