アクセシビリティ監査(WCAG 2.2 AA)
選択したトピックについて、現実的なアクセシビリティ問題のリストを作成します。各問題は小さなタスクに分解でき、フェーズ内で修正可能です。監査は読み取り専用です。明白な修正であっても監査中にアプリケーションコードを変更しないでください。修正は別のリクエストとして行います。
スキルディレクトリ:このSKILL.mdを含むフォルダ(以下 $SKILL、このリポジトリでは通常 .claude/skills/bbb-a11y-audit)。各ステップで必要な場合は以下のリファレンスを参照します。
references/criteria.md:55の達成基準、各レイヤーで評価可能なもの、BBBのホットスポット、カバレッジルールreferences/rubric.md:影響度、工数、今フェーズかバックログか、グルーピング、安定キー、findings.input.jsonのスキーマreferences/static-patterns.md:静的ツール、各パターンのトリアージ方法、eslintとaxeのマッピングreferences/bbb-map.md:フロー、コードの場所、共有コンポーネント、ランタイムレイヤーの実行方法references/manual-checks.md:スクリーンリーダーのスクリプトruntime/:ランタイムレイヤー。初回使用時にBigBlueButton Playwrightスイートにインストールされます:wcagAudit.spec.ts(シナリオ)、wcagAuditRecorder.ts(axe、スクリーンショット、各シナリオのJSON)、wcagAuditChecks.ts(キーボード、リフロー、テキスト間隔、ツールチップ、フォーカス復帰、ARIAステート)、wcagAuditAnnouncements.ts(ライブリージョンに到達した内容を記録)
1. スコープとモード
通常の作業方法は一度に1トピックです。ガイドラインを1つ選び、その中のすべてを監査し、見つかった問題を修正し、再度監査して完了したら次のトピックに移ります。フル監査は次のトピックを選択するための概要として時折使用します。
| 呼び出し方 | モード | スコープ |
|---|---|---|
/bbb-a11y-audit diretriz 2.1(または guideline、複数指定:diretriz 2.1 2.4、原則全体:principio 2) | guideline | トピックのすべての達成基準をクライアント全体とすべてのフローにわたって完全に判定。それ以外は実行およびレポートから除外されます。 |
/bbb-a11y-audit criterio 2.4.7(または criterion) | criterion | 1つ以上の達成基準、同様の深さ |
/bbb-a11y-audit または full | full | 55の達成基準すべて(全体像) |
/bbb-a11y-audit <path> | path | 指定されたフォルダまたはファイル、すべての達成基準 |
/bbb-a11y-audit diff [base] | diff | bigbluebutton-html5/以下で git merge-base HEAD <base> に対して変更されたファイル(デフォルトのbase:リポジトリのメインブランチ v4.1.x-develop) |
--no-runtime を追加 | ランタイムレイヤーをスキップ | |
--server <url> --secret <secret> を追加 | bigbluebutton-tests/playwright/.env の代わりに別のBigBlueButtonテストサーバーに対してランタイムレイヤーを実行(<url> は https://host/bigbluebutton/ の形式) |
リクエストがあいまいな場合は、最も近いモードを選択し、使用したモードを明示します。質問しないでください。
リポジトリルートに実行ディレクトリを作成します:a11y-reports/<YYYY-MM-DD_HHMM>[_<topic>]/raw/、例:2026-11-20_1430_d2.1 または 2026-11-20_1500_full。日付と時刻で始める必要があります。レポートは同一トピックの古い実行と比較します(principio 4 と diretriz 4.1 は同じトピックとして扱われます)。初回実行時は、トピックに絞り込んだ最新のフル実行と比較します。監査はリポジトリに痕跡を残さないでください:git check-ignore -q a11y-reports/ が失敗した場合は、a11y-reports/ を .git/info/exclude に追加します(このクローンにローカルで、決して .gitignore には追加しません)。
guideline および criterion モードでは、findings.input.json の meta.guidelines / meta.criteria を設定します(原則は1桁のガイドラインエントリとして扱います:principio 2 は `