mcpField
H
help-url-reference

help-url-reference

github.com/community-accessテスト・品質429132 回インストール今日更新
リポジトリ

help-url-reference について

help-url-reference は、アクセシビリティ監査やレポート生成向けのリファレンススキルです。ルール ID や基準を、ウェブおよび Microsoft Office 文書の外部改善ガイドに対応付けます。

主な機能

  1. 01axe-core ルール URL の構築
  2. 02ウェブのルールとヘルプ URL の対応
  3. 03W3C/WAI トピックの参照
  4. 04Word と Excel のルール参照

活用シーン

  1. 01監査結果に改善ガイドを付与
  2. 02CSV レポートにヘルプリンクを追加
  3. 03アクセシビリティレポートの生成

インストール

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

$npx skills add https://github.com/community-access/accessibility-agents --skill help-url-reference

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

詳細

ヘルプ URL リファレンス

アクセシビリティルール ID と WCAG 基準を外部のヘルプドキュメントに対応付ける一元管理されたマッピングです。CSV レポーター、監査レポート生成ツール、および検出結果を修正ガイダンスにリンクするあらゆるエージェントで使用されます。

Accessibility Insights（Web アクセシビリティ）

axe-core ルール URL のパターン
Base URL: https://accessibilityinsights.io/info-examples/web/
Pattern:  {base_url}{rule-id}
Example:  https://accessibilityinsights.io/info-examples/web/image-alt/

任意の axe-core ルールについて、ベース URL にルール ID を追加して URL を作成します。このパターンはすべての axe-core ルールに対応しています。

一般的な axe-core ルール
ルール ID問題WCAGヘルプ URL
image-alt画像に代替テキストがありません1.1.1https://accessibilityinsights.io/info-examples/web/image-alt/
button-nameボタンにアクセシブルな名前がありません4.1.2https://accessibilityinsights.io/info-examples/web/button-name/
color-contrastテキストのコントラストが不十分です1.4.3https://accessibilityinsights.io/info-examples/web/color-contrast/
labelフォーム要素にラベルがありません1.3.1https://accessibilityinsights.io/info-examples/web/label/
link-nameリンクに判別可能なテキストがありません4.1.2https://accessibilityinsights.io/info-examples/web/link-name/
html-has-langページに lang 属性がありません3.1.1https://accessibilityinsights.io/info-examples/web/html-has-lang/
document-titleページにタイトルがありません2.4.2https://accessibilityinsights.io/info-examples/web/document-title/
heading-order見出しレベルが飛んでいます1.3.1https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html
aria-roles無効な ARIA ロールです4.1.2https://accessibilityinsights.io/info-examples/web/aria-roles/
aria-required-attr必須の ARIA 属性がありません4.1.2https://accessibilityinsights.io/info-examples/web/aria-required-attr/
aria-valid-attr無効な ARIA 属性です4.1.2https://accessibilityinsights.io/info-examples/web/aria-valid-attr/
bypassナビゲーションをスキップするリンクがありません2.4.1https://accessibilityinsights.io/info-examples/web/bypass/
regionコンテンツがランドマーク内にありません1.3.1https://www.w3.org/WAI/WCAG22/Understanding/info-and-relationships.html
tabindex正の tabindex が使用されています2.4.3https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html
duplicate-id要素 ID が重複しています4.1.1https://accessibilityinsights.io/info-examples/web/duplicate-id/
focus-order-semanticsフォーカス順序に問題があります2.4.3https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html
input-image-alt画像入力に alt がありません1.1.1https://accessibilityinsights.io/info-examples/web/input-image-alt/
meta-viewportビューポートでズームが無効になっています1.4.4https://accessibilityinsights.io/info-examples/web/meta-viewport/
select-nameselect 要素にラベルがありません4.1.2https://accessibilityinsights.io/info-examples/web/select-name/
autocomplete-valid無効な autocomplete 値です1.3.5https://accessibilityinsights.io/info-examples/web/autocomplete-valid/
W3C/WAI トピックページ（axe 以外の問題）

axe-core のルール ID がないエージェント検出の問題には、次の W3C/WAI ページを使用します。

トピックURL
フォーカス管理https://www.w3.org/WAI/WCAG22/Understanding/focus-order.html
ライブリージョンhttps://www.w3.org/WAI/WCAG22/Understanding/status-messages.html
モーダルダイアログhttps://www.w3.org/WAI/ARIA/apg/patterns/dialog-modal/
データテーブルhttps://www.w3.org/WAI/tutorials/tables/

Microsoft Office（ドキュメントのアクセシビリティ）

Word（DOCX）ルール

ルール ID は、word-accessibility フォーマットエージェントの正式な定義と一致します。

ルール ID問題ヘルプ URL
DOCX-E001画像に代替テキストがありませんhttps://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669
DOCX-E002表のヘッダー行がありませんhttps://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5
DOCX-E003見出しレベルが飛ばされていますhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings
DOCX-E004ドキュメントのタイトルがありませんhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_doctitle
DOCX-E005表のセルが結合または分割されていますhttps://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5
DOCX-E006ハイパーリンクのテキストが曖昧ですhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_links
DOCX-E007見出し構造がありませんhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings
DOCX-E008ドキュメントへのアクセスが制限されています（IRM）https://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d
DOCX-E009コンテンツコントロールにタイトルがありませんhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d
DOCX-W001入れ子になった表https://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5
DOCX-W002代替テキストが長すぎます（150文字超）https://support.microsoft.com/en-us/office/everything-you-need-to-know-to-write-effective-alt-text-df98f884-ca3d-456c-807b-1a1fa82f5dc2
DOCX-W003リスト記号が手入力されていますhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d
DOCX-W004間隔を空けるための空白行が表にありますhttps://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5
DOCX-W005見出しが100文字を超えていますhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_headings
DOCX-W006透かしが設定されていますhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_watermarks
DOCX-T001ドキュメントの言語が設定されていませんhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_language
DOCX-T002レイアウト用の表にヘッダーのマークアップがありますhttps://support.microsoft.com/en-us/office/create-accessible-tables-in-word-cb464015-59dc-46a0-ac01-6217c62210e5
DOCX-T003空白文字が繰り返されていますhttps://support.microsoft.com/en-us/office/create-accessible-word-documents-d9bf3683-87ac-47ea-b91a-78dcacb3c66d#bkmk_whitespace
Excel（XLSX）のルール

ルール ID は、excel-accessibility 形式エージェントの標準定義と一致します。

ルール ID問題ヘルプ URL
XLSX-E001画像／グラフに代替テキストがないhttps://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669
XLSX-E002テーブルに見出し行がないhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_tableheaders
XLSX-E003既定のシート名https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_sheettabs
XLSX-E004データテーブル内の結合セルhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_mergedcells
XLSX-E005意味が曖昧なハイパーリンクテキストhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
XLSX-E006ブックのタイトルがないhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_doctitle
XLSX-E007負の数を赤色のみで表示する書式設定https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_color
XLSX-E008ブックへのアクセスが制限されている（IRM）https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
XLSX-W001書式設定のために使用されている空白セルhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
XLSX-W002色だけでデータを区別しているhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_color
XLSX-W003複雑なテーブル構造https://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_mergedcells
XLSX-W004空のワークシートhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
XLSX-W005代替テキストが長い（150 文字超）https://support.microsoft.com/en-us/office/everything-you-need-to-know-to-write-effective-alt-text-df98f884-ca3d-456c-807b-1a1fa82f5dc2
XLSX-T001シートタブの順序が論理的でないhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593#bkmk_sheettabs
XLSX-T002名前付き範囲がないhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
XLSX-T003ブックの言語が設定されていないhttps://support.microsoft.com/en-us/office/create-accessible-excel-workbooks-6cc05fc5-1314-48b5-8eb3-683e49b3e593
PowerPoint（PPTX）のルール

ルール ID は、powerpoint-accessibility フォーマットエージェントの標準定義に対応しています。

ルール ID問題ヘルプ URL
PPTX-E001画像の代替テキストがありませんhttps://support.microsoft.com/en-us/office/add-alternative-text-to-a-shape-picture-chart-smartart-graphic-or-other-object-44989b2a-903c-4d9a-b742-6a75b451c669
PPTX-E002スライドのタイトルがありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_slidetitles
PPTX-E003スライドのタイトルが重複していますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_slidetitles
PPTX-E004表のヘッダー行がありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_tableheaders
PPTX-E005ハイパーリンクのテキストが曖昧ですhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_links
PPTX-E006読み上げ順序が正しくありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_readingorder
PPTX-E007プレゼンテーションへのアクセスが制限されています（IRM）https://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25
PPTX-W001プレゼンテーションのタイトルがありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25
PPTX-W002レイアウトに表が使用されていますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_tableheaders
PPTX-W003表のセルが結合されていますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_tableheaders
PPTX-W004字幕のない音声／動画がありますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_captions
PPTX-W005色だけで意味を伝えていますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_color
PPTX-W006代替テキストが長すぎます（150文字超）https://support.microsoft.com/en-us/office/everything-you-need-to-know-to-write-effective-alt-text-df98f884-ca3d-456c-807b-1a1fa82f5dc2
PPTX-T001セクション名がありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25
PPTX-T002アニメーションが多すぎますhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25#bkmk_animations
PPTX-T003スライドのノートがありませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25
PPTX-T004プレゼンテーションの言語が設定されていませんhttps://support.microsoft.com/en-us/office/create-accessible-powerpoint-presentations-6f7772b2-2f33-4bd2-8ca7-dae3b2b3ef25

Adobe PDF

ルール ID問題ヘルプ URL
PDFUA.TaggedPDF文書にタグが付いていませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#tag_pdf
PDFUA.Title文書タイトルがありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#add_title
PDFUA.Language文書の言語が設定されていませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#set_language
PDFUA.BookmarksPresentブックマークがありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#bookmarks
PDFUA.AltText代替テキストがありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#alt_text
PDFUA.TableHeaders表の見出しがありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#tables
PDFUA.ReadingOrder読み上げ順序が正しくありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#reading_order
PDFUA.Headings見出し構造に問題がありますhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#headings
PDFUA.ListTagsリストタグがありませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#lists
PDFBP.Contrastテキストのコントラストが低すぎますhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#contrast
PDFBP.Scannedスキャンされた（画像のみの）PDFですhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#scanned
PDFQ.Searchableテキストを検索できませんhttps://helpx.adobe.com/acrobat/using/creating-accessible-pdfs.html#ocr

WCAG 2.2 解説ドキュメント

URL パターン
Base: https://www.w3.org/WAI/WCAG22/Understanding/
Pattern: {base}{slug}
達成基準とスラッグの対応
WCAG達成基準名スラッグ
1.1.1テキスト以外のコンテンツnon-text-content
1.3.1情報と関係性info-and-relationships
1.3.2意味のある順序meaningful-sequence
1.3.5入力目的の特定identify-input-purpose
1.4.1色の使用use-of-color
1.4.3コントラスト（最低限）contrast-minimum
1.4.4テキストのサイズ変更resize-text
1.4.5文字画像images-of-text
1.4.11テキスト以外のコントラストnon-text-contrast
2.1.1キーボードkeyboard
2.1.2キーボードトラップなしno-keyboard-trap
2.4.1ブロックのスキップbypass-blocks
2.4.2ページタイトルpage-titled
2.4.3フォーカス順序focus-order
2.4.6見出しとラベルheadings-and-labels
2.4.7フォーカスの可視化focus-visible
2.4.11フォーカスが隠れないこと（最低限）focus-not-obscured-minimum
2.5.8ターゲットサイズ（最低限）target-size-minimum
3.1.1ページの言語language-of-page
3.1.2部分の言語language-of-parts
3.3.1エラーの特定error-identification
3.3.2ラベルまたは説明labels-or-instructions
3.3.7冗長な入力redundant-entry
3.3.8アクセシブルな認証（最低限）accessible-authentication-minimum
4.1.2名前、役割、値name-role-value

アプリケーション固有の修正手順テンプレート

Word
ルール修正手順
DOCX-E001画像を右クリックし、「代替テキストの編集」を選択して説明を入力します
DOCX-E002「テーブル デザイン」タブで「ヘッダー行」チェックボックスをオンにします
DOCX-E003適切な見出しスタイルを適用します（「ホーム」タブ、「スタイル」グループ）
DOCX-E004「ファイル」→「情報」→「プロパティ」から「タイトル」欄を編集します
DOCX-E005「テーブル レイアウト」タブの「結合」グループで「セルの分割」を選択します
DOCX-E006リンクテキストを説明的な語句に置き換えます
DOCX-E007文書の各セクションに「見出し 1」スタイルを適用します
Excel
ルール修正手順
XLSX-E001グラフ／画像を右クリックし、「代替テキストの編集」を選択して説明を入力します
XLSX-E002「ホーム」から「テーブルとして書式設定」を選択します（「先頭行をテーブルの見出しとして使用する」オプションにチェックが入っていることを確認します）
XLSX-E003シートタブを右クリックし、「名前の変更」を選択して、内容がわかる名前を入力します
XLSX-E004セルの結合を解除し、データのレイアウトを再構成します
XLSX-E005リンクテキストを、内容がわかるフレーズに置き換えます
XLSX-E006「ファイル」から「情報」、「プロパティ」の順に選択し、「タイトル」欄を入力します
PowerPoint
ルール修正手順
PPTX-E001画像を右クリックし、「代替テキストの編集」を選択して説明を入力します
PPTX-E002「ホーム」から「レイアウト」を選択し、タイトルのプレースホルダーがあるレイアウトを選びます
PPTX-E003各スライドに固有のタイトルを入力します
PPTX-E004表を選択し、「テーブル デザイン」で「見出し行」にチェックを入れます
PPTX-E005リンクテキストを、内容がわかるフレーズに置き換えます
PPTX-E006「ホーム」から「配置」、「オブジェクトの選択と表示」の順に選択し、項目を下から上の順に並べ替えます
PDF（Acrobat Pro）
ルール修正手順
PDFUA.TaggedPDF「アクセシビリティ」から「文書にタグを追加」を選択します
PDFUA.Title「ファイル」から「プロパティ」を選択し、「概要」タブの「タイトル」欄を入力します
PDFUA.Language「ファイル」から「プロパティ」を選択し、「詳細設定」タブの「言語」ドロップダウンを選択します
PDFUA.ReadingOrder「ツール」から「アクセシビリティ」、「読み上げ順序」ツールの順に選択します

コメント

Markdown 対応