severity-mapping について
severity-mappingは、Web、ドキュメント、Markdownの監査で共通して使う重大度基準です。アクセシビリティ監査担当者やレポート作成者向けに、分野横断のスコア計算とWeb監査の確信度補正を定めています。
主な機能
- 014段階の標準重大度
- 02Web・文書・Markdownの対応表
- 03指摘ごとの減点規則
- 04ページ・ファイル単位の集計
- 05Web監査の確信度補正
活用シーン
- 01監査分野間で重大度を統一
- 02一貫したページ・ファイル評価
- 03Webスキャン間の指摘を重複排除
- 04確信度に応じたWeb監査の減点
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ community-access/ accessibility-agents --skill severity-mappingインストール後、Claude Code で/severity-mappingを入力して読み込まれたか確認します。
詳細
重大度マッピング
Web、ドキュメント、Markdown の監査領域で共有される標準の重大度定義です。
標準の重大度レベル
| レベル | 定義 | WCAG 適合性 | スコアへの影響 |
|---|---|---|---|
| Critical | 1 つ以上のユーザーグループが完全にアクセスできなくなります。回避策はありません。 | レベル A に不適合 | -15 ~ -22 ポイント |
| Serious | アクセスを著しく妨げます。回避策があっても、妥当とはいえません。 | レベル A または AA に不適合 | -5 ~ -10 ポイント |
| Moderate | 不便や混乱が生じますが、ほとんどのユーザーは引き続きタスクを完了できます。 | レベル AA に不適合(参考情報) | -2 ~ -4 ポイント |
| Minor | 仕上げに関する問題で、ほとんどのユーザーにとって重大な障壁にはなりません。 | 技法からの逸脱 | -1 ポイント |
領域間の同等レベル
| 標準レベル | Web(axe-core / Playwright) | ドキュメント(Office/PDF) | Markdown |
|---|---|---|---|
| Critical | critical(axe-core) | ドキュメントタイトルがない、タグなし PDF、見出し構造がない | ナビゲーションが機能しなくなるリンク切れのアンカー |
| Serious | serious(axe-core) | 情報を伝える画像に代替テキストがない、表に見出しがない | リンクテキストが曖昧(例:「ここをクリック」)、画像に代替テキストがない |
| Moderate | moderate(axe-core) | 表のセルが結合されている、色だけでデータを表現している | 見出しレベルの飛び越し、表のキャプションがない |
| Minor | minor(axe-core) | 装飾画像に空でない代替テキストがある、冗長なブックマーク | 見出し内の絵文字、リストの区切りに em ダッシュを使用 |
スコアへの影響に関するルール
上記のスコアへの影響は、検出事項ごとに加算されます。同じ問題が多くの要素で繰り返される場合:
- 最初の発生 — 全額を減点
- 同じ種類の問題、同じページ/ファイル — 追加の減点なし(問題ごとに 1 回だけ計上するルールにより、すでに計上済み)
- 同じ種類の問題、異なるページ/ファイル — 新しいページ/ファイルのスコアに対して、再度全額を減点
変換ルール(領域間レポートの標準化)
Web、ドキュメント、Markdown の検出事項を統合したレポートを生成する場合:
- 上記の表を使って、各検出事項を標準の重大度レベルにマッピングします。
- 領域固有ツールの内部スコアではなく、標準レベルのスコアへの影響を適用します。
- 集計スコア(ポートフォリオまたはプロジェクトレベル)では、各ページ/ファイルのスコアを個別に算出してから平均します。
- axe-core のスキャンと Playwright の動作スキャンの両方に現れる検出事項を二重に計上しないでください。ルール ID と要素の位置で重複を除外します。
信頼度補正(Web 領域)
Web 監査では、信頼度レベルに応じて基本減点を補正します。
| 信頼度 | 乗数 | 情報源のシグナル |
|---|---|---|
| Confirmed | 1.2x | axe-core + エージェントによるコードレビュー + Playwright による動作テスト |
| High(2 つの情報源) | 1.0x | 上記 3 つの情報源のうち、任意の 2 つ |
| High(1 つの情報源) | 1.0x(基本減点を軽減) | 単一の自動化ツール、ルールの信頼性が高い |
| Medium | 0.7x | 単一の情報源、ルールの信頼性が中程度 |
| Low | 0.3x | 単一の情報源、ルールの信頼性が低い、またはヒューリスティック |
ドキュメントおよび Markdown の監査では信頼度の乗数を使用せず、基本スコアへの影響のみを適用します。
コメント
Markdown 対応