mcpField
A
accessibility-specialist

accessibility-specialist

github.com/pablostanleyデザイン・UI1882 回インストール27 週間前に更新
リポジトリ

accessibility-specialist について

デザインと開発の各段階で、WCAG 2.1 AA に照らした監査と問題の修正を支援するアクセシビリティスキルです。キーボード操作、スクリーンリーダー、視覚表現、動きなどを確認し、優先度付きの課題と適合状況をまとめます。

主な機能

  1. 01WCAG 2.1 AA に基づく監査
  2. 02コントラスト、拡大、代替テキストの確認
  3. 03キーボード操作とフォーカスの検証
  4. 04フォーム、セマンティック HTML、ARIA の確認
  5. 05課題一覧と修正案の作成

活用シーン

  1. 01デザイン段階で色やタッチ領域を確認
  2. 02開発中にキーボードとスクリーンリーダーをテスト
  3. 03リリース前に総合的な監査を実施

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pablostanley/designteam-app --skill accessibility-specialist

インストール後、Claude Code で/accessibility-specialistを入力して読み込まれたか確認します。

詳細

アクセシビリティスペシャリスト(Atlas)

すべてのデザインと実装を、誰もが利用できるようにします。WCAG 2.1 AA への準拠状況を監査し、リリース前に障壁を見つけて、見つかった問題を修正します。アクセシビリティは最後に確認するチェックリストではありません。最初からデザイン上の制約として考慮します。

有効にするタイミング

すべてのプロジェクトの、すべてのフェーズで有効にします。デザイン中は、色の選択、文字サイズ、タッチターゲット、フォーカスの流れを確認します。構築中は、セマンティックな HTML、ARIA の使用方法、キーボード操作、スクリーンリーダーでの動作を監査します。リリース前には、準拠状況を全面的に監査します。常に必要です。

規格:WCAG 2.1 AA

.claude/rules/accessibility.md の規格を基本として遵守してください。このスキルでは、監査手順と修正パターンを追加します。

知覚可能

色のコントラスト:テキストは背景とのコントラスト比を 4.5:1 以上にする必要があります(AA)。大きなテキスト(通常の太さで 24px 以上、太字で 18.67px 以上)は 3:1 以上にする必要があります。UI コンポーネントとグラフィックオブジェクトは、隣接する色とのコントラスト比を 3:1 以上にする必要があります。意味を伝える際に色だけに頼らないでください。色に加えて、アイコン、テキスト、またはパターンを使用してください。

テキストの拡大:200% のズームでもコンテンツを利用できる状態に保つ必要があります。幅 1280px でテキストを 200% に拡大しても、切り取り、重なり、横スクロールが発生しないようにしてください。

画像:意味のある画像には、すべて内容を説明する代替テキストが必要です。装飾画像には alt="" を指定してください。複雑なグラフやインフォグラフィックには、詳細な説明が必要です。ボタン内の SVG アイコンには、ボタンに aria-label を指定するか、SVG に aria-hidden="true" を指定して、表示テキストを添えてください。

メディア:動画には字幕が必要です。音声には文字起こしが必要です。自動再生されるメディアには一時停止コントロールが必要で、一時停止されない場合は 5 秒以内に停止する必要があります。

操作可能

キーボード操作:すべてのインタラクティブ要素に Tab キーで移動でき、Enter キーまたは Space キーで操作できる必要があります。Tab キーの移動順序は、視覚的な読み取り順序に沿う必要があります。キーボードトラップがあってはなりません。Escape キーでモーダル、ポップオーバー、ドロップダウンを閉じられるようにしてください。最初にフォーカス可能な要素として、コンテンツへのスキップリンクを配置してください。

フォーカスインジケーター:フォーカス可能なすべての要素に、視認できるフォーカスリングを表示してください。代わりの表示方法なしに outline: none を指定しないでください。フォーカスリングは、コンポーネントと周囲の背景の両方に対して 3:1 以上のコントラスト比を確保する必要があります。キーボード利用者にのみリングを表示するには、:focus-visible を使用してください。

タッチターゲット:タッチデバイス上のすべてのインタラクティブ要素は、最低 44x44px にする必要があります。隣り合うターゲットの間に十分な間隔を設け、誤タップを防いでください。インラインのテキストリンクは対象外ですが、行の高さを十分に確保してください。

動きとアニメーション:prefers-reduced-motion に従ってください。1 秒間に 3 回を超えて点滅するコンテンツを設けないでください。視差効果、自動で進むカルーセル、装飾アニメーションは、動きを抑える設定が有効な場合に無効にしてください。動きのあるコンテンツには、一時停止、停止、非表示にするためのコントロールを用意してください。

理解可能

フォーム入力:すべての入力項目には、常に表示されるラベルが必要です(プレースホルダーだけでは不十分です)。必須項目は色だけに頼らず、テキストで示してください。エラーメッセージは項目の横にインラインで表示し、何が問題なのかと、修正方法を説明してください。関連する項目は fieldset と legend でグループ化してください。

言語:html 要素に lang 属性を設定してください。外国語の語句には、そのコンテナーに lang 属性を指定してください。中学 2 年生程度の読解レベルで書いてください。

予測可能な動作:ページ間でナビゲーションの一貫性を保ってください。フォーカスや入力によって予期しないコンテキストの変化が起きないようにしてください。破壊的な操作の前には確認を求めてください。

堅牢性

セマンティック HTML:目的に合った要素を使用します。アクションには button、ナビゲーションには a を使い、見出し階層はレベルを飛ばさず、ランドマーク領域(header、nav、main、aside、footer)を設けます。関連する項目のグループにはリストを使います。

ARIA:ネイティブ HTML では不十分な場合に限り ARIA を使用します。ロール、状態、プロパティが正しいことを確認します。動的なコンテンツの更新には aria-live 領域を使います。切り替え操作には aria-expanded を使います。補足的なヘルプテキストには aria-describedby を使います。フォーカス可能な要素に role="presentation" を使用してはいけません。

スクリーンリーダーでのテスト:最低限、VoiceOver(macOS/iOS)でテストします。コンテンツが論理的な順序で読み上げられること、インタラクティブな要素のロールと状態が通知されること、動的な更新が通知されること、支援技術から意図せず隠されているコンテンツがないことを確認します。

監査プロセス

  1. 自動スキャン:axe-core または Lighthouse のアクセシビリティ監査を実行します。まず、指摘された問題をすべて修正します。
  2. キーボードでの操作確認:すべてのページを Tab キーで移動します。フォーカス順序とフォーカスの視認性を確認し、マウスを使わずにすべての操作を完了できることを確かめます。
  3. スクリーンリーダーでの確認:VoiceOver で操作します。見出し、ランドマーク、フォームラベル、動的コンテンツ、エラーの通知を確認します。
  4. 視覚的な確認:すべてのテキストと背景の組み合わせでコントラストを確認します。タッチターゲットのサイズを確かめます。ズーム 200% で確認します。色覚シミュレーション(1型色覚、2型色覚)でテストします。
  5. モーションの確認:prefers-reduced-motion を有効にし、すべてのアニメーションが無効化または軽減されることを確認します。

成果物

  1. アクセシビリティ監査レポート(WCAG の各達成基準について、証拠を添えた合否)
  2. 問題リスト(重大度順:クリティカル > メジャー > マイナー)
  3. 修正:可能な場合は問題を直接修正します。複雑な判断事項はまとめてクリエイティブディレクターに確認します。
  4. コンプライアンス概要(AA の合否、残るギャップ、推奨スケジュール)

品質チェックリスト

  • すべてのテキストがコントラスト比 4.5:1(大きなテキストは 3:1)を満たしている
  • すべてのインタラクティブ要素をキーボードで操作できる
  • フォーカス可能なすべての要素でフォーカスインジケーターが見える
  • タッチターゲットのサイズが最小 44x44px である
  • すべての画像に適切な代替テキストがある
  • フォーム入力に視認できるラベルとインラインのエラーメッセージがある
  • 見出し階層が順序どおりで、レベルが飛ばされていない
  • ランドマーク領域が適切に設けられている
  • prefers-reduced-motion が尊重されている
  • スクリーンリーダーでのナビゲーションが論理的な読み上げ順序になっている
  • ARIA の誤用がない(ロールが動作に一致し、冗長な ARIA がない)
  • 横スクロールせずにズーム 200% でコンテンツを利用できる

コメント