前言¶

网站要满足无障碍合规或产品内建可访问性时，团队往往要对照 WCAG 条文逐项排查：自动化工具能扫出一批问题，但结论仍要人工核对语境；修完一轮还要对照成功标准写修复说明。若把这些流程拆成 checklist 再交给大模型，提示词容易漏步骤、标准版本也对不齐。

下面介绍 SkillHub 上的 wcag-audit-patterns（坐标 @org-02qudk26/wcag-audit-patterns）。它把自动化测试、人工验证与修复指导串成一套面向 WCAG 2.2 的审计工作流，适合在 Cursor 等支持 Skills 的 Agent 里启用后，对站点做可访问性审计或跟进违规修复。

这是什么¶

wcag-audit-patterns 是企业来源（enterprise）的 Agent Skill，当前版本 1.0.0，由 智雨科技 发布，在 SkillHub 分类为 it-ops-security。

官方简介概括为：使用自动化测试、人工验证和修复指导，开展 WCAG 2.2 可访问性审计；适用于对网站进行可访问性审计、修复 WCAG 违规问题或实现可访问性设计模式。标签标明 requires_api_key=false，安装后不需要额外配置 API Key 即可按 Skill 内指引使用。

核心功能¶

依据 SkillHub 公开说明，该 Skill 覆盖三类能力，且都围绕 WCAG 2.2：

1. 自动化测试：在审计流程中纳入可自动执行的检测步骤，用于快速发现常见可访问性问题（具体工具与命令以 Skill 包内 SKILL.md 及引用文档为准）。
2. 人工验证：对自动化结果无法单独定论的项，按 WCAG 要求做人工核对，避免「工具报绿但真实体验仍不可用」。
3. 修复指导：针对违规或风险项，给出可落地的修复方向，便于开发与设计按成功标准改代码或改模式。

Skill 采用通用 SKILL.md 格式，由 Agent 读取后按其中步骤推进任务，而不是替代法务或第三方认证机构的正式合规签字。

安装与启用¶

安装前需本机已有 SkillHub CLI。若尚未安装，可先检查版本：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI 时：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装 wcag-audit-patterns 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。SkillHub 页面给出的安装方式为：参照 SkillHub 安装说明，安装坐标 @org-02qudk26/wcag-audit-patterns。命令行示例如下（将 <skills 目录> 换成你当前环境的路径）：

skillhub install @org-02qudk26/wcag-audit-patterns --dir <skills 目录>

常用客户端 skills 目录（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后，按你所用客户端要求重启或刷新 Agent，使新 Skill 被识别。也可在对话中让 AI 根据 https://skillhub.cn/install/skillhub.md 代为完成安装，坐标同样为 @org-02qudk26/wcag-audit-patterns。

典型用法¶

公开页面未附带独立 demo 仓库；典型用法是 在已启用该 Skill 的 Agent 会话里，用自然语言说明审计目标，由 Skill 引导走完「自动化 → 人工验证 → 修复建议」链路。可按下面顺序发起任务（表述可调整，但意图应对齐官方三类能力）：

1. 说明待审计对象（例如某站点 URL、本地构建地址，或当前仓库中的前端页面路径）。
2. 明确要求按 WCAG 2.2 做可访问性审计，并先执行 Skill 中的自动化测试步骤。
3. 对自动化结果中的疑点项，要求按 Skill 指引做人工验证并标注对应成功标准层级（A / AA 等，以 Skill 内框架为准）。
4. 对确认违规或高风险项，要求输出修复指导，便于开发修改 markup、样式、交互或文案。

若项目处于迭代期，也可在同一 Skill 下要求「实现某可访问性设计模式」或「针对上一轮违规项做回归审计」，仍应让 Agent 显式引用 wcag-audit-patterns，避免泛化回答偏离 WCAG 2.2。

适用场景与注意¶

适合谁

• 前端、全栈或 QA 需要在发版前做一轮 WCAG 2.2 导向的自查。
• 团队要把可访问性修复写成可跟进的条目，而不是零散 issue 标题。
• 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望把审计流程固化成可重复对话模板。

使用上需注意

• 自动化扫描不能覆盖全部成功标准；Skill 强调人工验证，正式对外合规仍建议结合法务要求与专业审计。
• SkillHub 统计（截至页面抓取）：评分约 100000，下载约 1100 次；具体行为以本地安装的 1.0.0 包内容为准，升级后应重新阅读 SKILL.md。
• 无需 API Key，但若你自行接入第三方扫描服务，密钥与网络策略需自行管理，不属于该 Skill 标签承诺范围。

结尾¶

wcag-audit-patterns 把 WCAG 2.2 审计拆成自动化检测、人工核对与修复指导，适合放进 Agent 工作流做站点可访问性自查与整改跟进。安装与坐标以 SkillHub 为准：

• Skill 页面：https://www.skillhub.cn/skills/org-02qudk26/wcag-audit-patterns
• API 坐标入口：https://api.skillhub.cn/org-02qudk26/wcag-audit-patterns
• 安装文档：https://skillhub.cn/install/skillhub.md