1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | accessibility-addyosmani-web-quality-skills | GitHub 合集仓库子目录（web-quality-skills 仓库内 skills/accessibility） |
| 作者/维护者 | Addy Osmani（Google 前总监，现从事 Gemini 与 Google Cloud 相关工作） | GitHub API |
| 来源链接 | https://github.com/addyosmani/web-quality-skills/tree/main/skills/accessibility | — |
| 许可证 | MIT | GitHub API |
| GitHub Stars / Forks | 2,533 / 230（该数字属整个 web-quality-skills 合集仓库，不代表本子技能自身热度） | GitHub API（认证取数） |
| 子技能版本 | SKILL.md 内标注 version 1.1 | 仓库文件核实 |
| 安装方式 | CLI 一键安装，或 Claude Code / Codex / Gemini CLI 官方插件市场安装 | 官方 README |
2. 功能介绍与亮点
accessibility 是 web-quality-skills 合集中专注网页无障碍（a11y）审计与修复的子技能，内容对照 WCAG 2.2 标准与 Google Lighthouse 无障碍审计项组织：
- 按 WCAG 的 POUR 四原则（可感知、可操作、可理解、健壮性）逐条给出可直接套用的 HTML/ARIA/CSS 修复模式，如图片替代文本、图标按钮无障碍命名、颜色对比度、视觉隐藏文案等，每条都配“错误写法 vs 正确写法”代码对比。
- 区分 A / AA / AAA 三档合规等级，AA 级明确标注为多数司法辖区的合规底线。
- 附带独立参考文件
A11Y-PATTERNS.md（可复用代码模式集）与WCAG.md（标准条款速查），SKILL.md 正文保持精简、细节下沉到引用文件。 - 纯 Markdown 内容，不含任何可执行脚本，安装即用。
- 仓库整体已合并多个第三方贡献者的 PR，包括新增 Gemini CLI 扩展支持、Claude Code 插件市场支持、Codex 插件支持等跨平台适配工作。
3. 适用场景
所属分类：前端与设计
适合需要对网页做无障碍合规审计、修复屏幕阅读器/键盘导航问题、或准备满足 WCAG AA 合规要求的前端开发者与小团队，尤其是没有专职无障碍工程师、需要 AI 直接给出可落地修复代码的场景。不涉及性能优化、SEO 等其他 Web 质量维度（合集内另有独立子技能覆盖）。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 提供官方插件市场安装命令（/plugin marketplace add + /plugin install），且有已合并 PR 专门添加该支持 |
| Codex | 原生支持 | README 提供 Codex 插件市场安装命令（codex plugin marketplace add），且有已合并 PR 专门添加该支持，另有独立 PR 修复 Windows 下的技能发现问题 |
| OpenClaw | 未验证 | 已抓取材料未点名 OpenClaw 适配 |
| Hermes Agent | 未验证 | 已抓取材料未点名 Hermes 适配 |
（README 另提供 Gemini CLI 扩展安装方式与手动复制到技能目录的通用安装法，理论上适用于任何支持 Markdown 技能规范的 Agent，但已抓取材料未点名 OpenClaw / Hermes 的具名验证记录。）
5. 推荐理由
多数“网页质量优化”类工具把无障碍当作性能审计的附属项一带而过，而这个子技能把无障碍单独拆出来做成一份可直接执行的修复手册：每条 WCAG 条款都配好代码级修复示例，AA/AAA 分级清晰，不需要额外配置或付费依赖，复制进技能目录即可用。仓库已有来自无障碍领域真实从业者的关注与讨论，且被合并的多平台适配 PR 证明其兼容性经过第三方实际验证，而非仅停留在文档承诺。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 合集仓库整体 2,533 stars 属整个仓库，不代表本子技能自身热度；本子技能自身有真实第三方信号：一位活跃于无障碍领域、自己维护同类项目的开发者专门开 issue 讨论该技能，且有外部贡献者提交并被合并的文档修订 PR；作者本人是知名开发者（Google 前总监，GitHub 5 万+ 关注者） |
| 可用性 | 9 | 纯 Markdown 技能，无需任何 API Key 或付费依赖；CLI 一条命令即可安装，Claude Code / Codex / Gemini CLI 均有官方插件市场支持并经第三方 PR 验证；内容详尽且拆分出独立参考文件，最近一次内容更新在 2026 年 5 月 |
| 安全性 | 9 | 见下方安全检查清单 |
| 综合评分 | 8.0 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 该子技能目录内仅含 SKILL.md 与两份参考 Markdown 文件，不含任何可执行脚本 |
| ② 运行时联网外发 | 无网络请求，纯静态知识与代码模式参考 |
| ③ API Key/凭据 | 不需要任何 API Key 或凭据 |
| ④ 可疑指令排查 | 已抓取 SKILL.md 与参考文件全文，内容均为 WCAG 标准条款与代码修复示例，未发现 prompt injection 或混淆代码迹象 |
| ⑤ 作者/组织信誉 | 作者为 Google 前总监级公开身份人物，仓库提交历史公开透明，无刷星迹象 |
| ⑥ License | MIT，条款清晰 |
| ⑦ 最近维护 | 该子技能最近一次内容更新为 2026 年 5 月，合集仓库整体在近期仍有持续提交 |
纯提示词/参考文档类技能，无代码执行、无外联、无凭据依赖，各项检查结果良好。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| accessibility-skills（mgifford） | 由一位长期活跃于无障碍领域的开发者维护，内容镜像其个人维护的无障碍标准速查站点 | 体量更小、更偏个人知识库性质；本 skill 背靠体量更大的 web-quality-skills 合集，内容组织更系统化（POUR 四原则 + 独立参考文件拆分），且已有多平台插件市场适配的实际验证 |
| web-quality-audit（同合集内综合审计子技能） | 一次性跑完性能、无障碍、SEO、最佳实践四个维度的综合审计 | 定位是“全面体检”，无障碍只是其中一项，不深入到 WCAG 逐条修复模式；本 skill 专注无障碍单一维度，修复指引更细致、更贴近实际改代码场景 |
多数网页质量类工具把无障碍当作综合审计里的一个子项带过，给出的通常是问题清单而非可直接套用的修复代码；这个子技能反其道而行，把无障碍单独拆出来做成一份对照 WCAG 条款、附代码示例的操作手册，兼顾深度与可执行性。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；但仓库 issue 区可见一位长期维护同类无障碍知识库的开发者主动参与讨论，认可其内容方向。
9. 其他补充
web-quality-skills 合集内还包含 performance、core-web-vitals、seo、best-practices、web-quality-audit 等其他子技能，覆盖网页质量的其他维度，可按需单独安装组合使用。
10. 安装使用方式
# 方式一：CLI 一键安装（安装整个合集，含本子技能）
npx skills add addyosmani/web-quality-skills
# 方式二：仅复制本子技能
git clone https://github.com/addyosmani/web-quality-skills /tmp/web-quality-skills
cp -r /tmp/web-quality-skills/skills/accessibility ~/.claude/skills/
# 方式三：Claude Code 插件市场
/plugin marketplace add addyosmani/web-quality-skills
/plugin install web-quality-skills@addy-web-quality-skills
# 方式四：Codex 插件市场
codex plugin marketplace add addyosmani/web-quality-skills安装后无需重启；下次对话中提出“检查无障碍”“a11y audit”“WCAG 合规”“屏幕阅读器支持”“键盘导航”等需求即可自动触发。Claude Code 插件安装后技能会带命名空间前缀（如 /web-quality-skills:accessibility）。
11. 注意事项
- 本 skill 是合集仓库中的一个子目录，安装时需注意只复制
skills/accessibility目录（含 SKILL.md 与 references/ 子目录），不要拆散文件结构。 - 内容基于 WCAG 2.2 标准，若后续标准版本更新，仓库是否及时跟进有待观察。
- 仅覆盖无障碍这一个 Web 质量维度，性能、SEO 等需求需安装合集内的其他子技能。
- 目前仅验证了 Claude Code 与 Codex 平台的官方适配，OpenClaw、Hermes Agent 生态的兼容性尚未验证。