mcpField
H
help-url-reference

help-url-reference

github.com/community-access测试与质量429132 次安装今天更新
代码仓库

关于 help-url-reference

help-url-reference 是供无障碍审计和报告工具使用的参考技能，将规则 ID 与标准映射到网页及 Microsoft Office 文档的外部整改指南。

主要功能

  1. 01构造 axe-core 规则链接
  2. 02网页规则与帮助链接映射
  3. 03W3C/WAI 主题参考
  4. 04Word 和 Excel 规则参考

适用场景

  1. 01为审计发现添加整改指南
  2. 02向 CSV 报告添加帮助链接
  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 报告器、审计报告生成器以及任何将问题关联到修复指南的 Agent 使用。

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 规则，将规则 ID 附加到基础 URL 即可构造 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-rolesARIA 角色无效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-attrARIA 属性无效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使用了正值 tabindex2.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输入图片缺少 alt1.1.1https://accessibilityinsights.io/info-examples/web/input-image-alt/
meta-viewport视口设置禁用了缩放1.4.4https://accessibilityinsights.io/info-examples/web/meta-viewport/
select-name选择元素没有标签4.1.2https://accessibilityinsights.io/info-examples/web/select-name/
autocomplete-validautocomplete 值无效1.3.5https://accessibilityinsights.io/info-examples/web/autocomplete-valid/
W3C/WAI 主题页面（非 axe 问题）

对于没有 axe-core 规则 ID、由 Agent 检测到的问题，请使用以下 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 格式 Agent 中的规范定义一致。

规则 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 格式 Agent 中的规范定义相匹配。

规则 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 格式 Agent 中的规范定义相匹配。

规则 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扫描版（仅图像）PDFhttps://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}
成功标准与 Slug 的映射
WCAG标准名称Slug
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