Communityコーディング&開発github.com

bbb-a11y-audit

BigBlueButton HTML5クライアントをWCAG 2.2レベルAおよびAA(EN 301 549 第9条)に基づいて監査し、ガイドライン・達成基準ごと、またはクライアント全体を対象に、原則・ガイドライン・達成基準で整理されたHTMLレポートを生成します。各達成基準は適合・不適合・非該当で判定され、証拠、注釈付きスクリーンショット、修正案、優先度が含まれます。

bbb-a11y-audit とは?

このスキルは、BigBlueButton(BBB)HTML5クライアントのアクセシビリティ監査を自動化・構造化するためのものです。ユーザーが「WCAG監査」「a11yレポート」「アクセシビリティ回帰チェック」などを依頼した際に、指定されたトピック(ガイドライン、達成基準、原則、またはクライアント全体)に対して詳細な監査を実行します。監査は3つのレイヤーで構成されています。(1)静的レイヤー:eslintとカスタム静的スキャンでコード上の問題を検出。(2)ランタイムレイヤー:Playwrightとaxe-coreを用いて実際のBBBミーティングを実行し、キーボード操作、リフロー、テキスト間隔、ARIAステートなどをテスト。(3)ガイド付きコードレビュー:開発者がコードを直接確認し、自動化では検出できない問題を発見します。結果はHTMLレポートとして出力され、前回の同一トピック実行結果との比較も行います。このスキルはClaude CodeおよびBigBlueButtonのPlaywrightテストスイートをサポートしており、BBBのアクセシビリティ品質を継続的に改善するための強力なツールです。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gugeldev/bbb-a11y-audit/tree/main/bbb-a11y-audit

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

アクセシビリティ監査(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)criterion1つ以上の達成基準、同様の深さ
/bbb-a11y-audit または fullfull55の達成基準すべて(全体像)
/bbb-a11y-audit <path>path指定されたフォルダまたはファイル、すべての達成基準
/bbb-a11y-audit diff [base]diffbigbluebutton-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 は `

関連スキル