前言¶

網站要滿足無障礙合規或產品內建可訪問性時，團隊往往要對照 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