89jobrien-web-accessibility：WCAG 2.1/2.2 网页无障碍审计与修复排序 Skill Skill 技能

技能简介

web-accessibility（slug：89jobrien-web-accessibility）是开发者 Joseph OBrien 发布的网页无障碍审计 Skill，面向 Claude、Codex、Claude Code，把 WCAG 2.1/2.2 的合规检查拆成「结构—键盘—色彩—表单—修复排序」五条可执行清单。它刻意不依赖自动化扫描分数，而是让助手逐项审查语义化标签、标题层级、地标区域与 ARIA 的使用位置，再产出按严重度和受影响用户排序的问题列表。技能在 Skillstore 通过完整安全审计，11 个外部命令类告警经复核全部来自 Markdown 代码块示例，MIT 协议，质量分 82（银级），页面浏览 187 次、下载 52 次。

核心能力

1. WCAG 2.1/2.2 符合性评估：按 Level AA / AAA 逐条对照，并说明每条准则的判定依据。
2. 语义结构审查：检查 HTML 语义标签、标题层级、landmark 区域与 ARIA 角色是否用在正确位置。
3. 键盘可达性检查：核对 Tab 顺序、焦点可见性、跳转链接、焦点陷阱与所有可操作控件。
4. 感知与对比度：对照 AA / AAA 目标检查色彩对比度，识别只用颜色传达状态或错误的写法。
5. 表单与替代文本：审查图片文字替代、表单标签、错误提示与状态播报是否完整可读。
6. 产出按优先级排序的修复清单，标注严重度、受影响用户与需要改动的位置。

安装配置

1. Skillstore 详情页提供三种安装方式：把 Agent 请求贴给助手、CLI 一行命令、手动下载 zip 放入技能目录。
2. 本技能 slug 为 89jobrien-web-accessibility，CLI 采用 npx skillstore add / 格式，具体命令以详情页 Install 段为准。
3. 支持 Claude、Codex、Claude Code；版本 1.0.1、Skillstore 修订 r1、version status valid，artifact signature 可用，审计状态 complete。
4. 风险因子声明为 external_commands（审计结论为文档示例而非真实命令执行）；建议首次安装后先人工通读 SKILL.md 再启用。

使用步骤

1. 在会话中加载该技能，并明确目标页面 URL、组件范围与目标 WCAG 等级。
2. 用「快速 WCAG 检查」类提示，让助手审查标题、链接、图片、表单与色彩对比度。
3. 单独跑一轮键盘可达性审查：Tab 顺序、焦点可见性、跳转链接、焦点陷阱与可操作控件。
4. 让助手输出组件级整改方案，按语义、ARIA、焦点管理、错误提示四组给出修改建议。
5. 汇总成发布前审计报告，按严重度、准则条目、受影响用户与修复建议分组，交给团队跟踪。

适用场景

1. 版本发布前对关键页面做一轮 WCAG 问题盘点，避免上线后被用户投诉。
2. 设计交付前检查焦点态、键盘流程、表单标签与色彩对比度是否达标。
3. 需要为合规审查或客户交付准备结构化的无障碍问题清单。
4. 存量站点整改：先拿到按影响排序的清单，再据此排期改造顺序。

适用人群

前端与全栈开发者、UI/UX 设计师、负责合规与可访问性的产品团队，以及需要向客户提供无障碍整改报告的外包与咨询团队。

工作原理

技能把 WCAG 准则与提示模板注入助手上下文，助手依据这些规则对页面源码、截图或线上地址做静态审查，并把每条发现绑定到具体准则、严重度与受影响用户，再输出修复优先级。它本身不运行自动化浏览器测试，也没有屏幕阅读器，因此精确结论依赖你提供的页面源码、截图或可访问站点；技能同时声明，正式合规判定仍需法律或组织层面复核，也不应只凭自动化分数就通过无障碍审批。

官方链接

• Skillstore 详情页：https://skillstore.io/skills/89jobrien-web-accessibility
• Manifest：https://skillstore.io/api/skills/89jobrien-web-accessibility/manifest
• 源仓库：https://github.com/89jobrien/steve/tree/main/steve/skills/web-accessibility （MIT）