figma-audit-accessibility

figma-audit-accessibility — コンポーネント単位のアクセシビリティ採点表

単一のコンポーネントまたはコンポーネントセットを対象に詳細なアクセシビリティ監査を実行し、優先度付きの修正項目と、重み付けされた0～100の採点表を取得します。figma-lint-designがツリー全体を検査して多くのルール違反を検出するのに対し、このスキルは1つのコンポーネントを詳しく調べます。バリアントの軸を把握し、コンポーネントをインタラクティブとプレゼンテーショナルのどちらかに分類して、それに応じて各アクセシビリティ項目を採点します。

どのプランでも、すべてuse_figma経由で実行します。実際のバリアントツリー、塗り、線、エフェクト、コンポーネントの説明を検査します。

スキルの適用範囲

• use_figmaのルール — まず公式の**figma-use**スキルを読み込んでください。これはFigma Plugin APIの完全なリファレンスです。スクリプトで必要となる基本事項：トップレベルのawaitとreturnを使ったプレーンなJS（IIFE、figma.closePlugin()は使用しない。console.logの内容は返されません）、各スクリプトの先頭で入力をconstとしてインライン化する、色は0～1の範囲で指定する、テキスト操作の前にフォントを読み込む、await figma.getNodeByIdAsync(...)を使う、アトミックエラー（スクリプトが失敗すると変更は一切適用されません。エラーを読み、修正して再試行してください）。
• ツリー全体のWCAGとデザインシステムのリント → figma-lint-designを使用してください。
• コード側のアクセシビリティ（HTMLに対するaxe-core）→ figma-scan-code-accessibilityを使用してください。
• デザインとコードの差異 → figma-check-design-parityを使用してください。

ワークフロー

1. コンポーネントを指定します。 NODE_IDにCOMPONENT_SET、COMPONENT、またはINSTANCEのIDを設定します（スクリプトがINSTANCE → メインコンポーネント → 親セットを自動的にたどります）。現在選択している単一の項目を監査する場合は、nullのままにしてください。
2. タップ対象の最小サイズを設定します。 TARGET_SIZEのデフォルトは24（WCAG 2.5.8の最小値）です。モバイルでより厳しいサイズを適用する場合は、44または48を指定してください。
3. 実行します。 scripts/audit-accessibility.jsをuse_figma経由で実行します（skillNames: "figma-audit-accessibility"）。
4. 採点表を確認します。 overallScoreは、6つのカテゴリのスコアを分類に応じて重み付けして組み合わせたものです。各カテゴリ、その重み、およびスコアを上げる方法については、references/audit-categories.mdを参照してください。
5. 推奨事項に対応します。 recommendations[]は、WCAG SC名とともにpriority（high／medium／low）の順に並んでいます。修正したら再実行し、スコアが変化したことを確認してください。

主なルール

• インタラクティブかプレゼンテーショナルかは、コンポーネント名とバリアントの軸から自動検出されます。これによって、採点されるカテゴリと重みが変わります。バッジにはフォーカス状態がなくても減点されませんが、ボタンは減点されます。
• **色は0～1の浮動小数点数です。**コントラストにはsRGB輝度を使用し、色覚特性のシミュレーションにはBrettel／Viénotの二色覚行列を使用します。
• 網羅性とは、インタラクティブコンポーネントではインタラクション状態の網羅を、プレゼンテーショナルコンポーネントではバリアント軸の完全性（実際のバリアント数 ÷ 想定される組み合わせ数）を意味します。
• この監査は読み取り専用です。figma-manage-variables／figma-useで修正を適用してから、再監査してください。