Communitygithub.com

可及性審查

用於審查 UI 的鍵盤操作、焦點、可及性名稱、結構、對比度與動態行為。

可及性審查 是什麼?

此技能提供一個詳細的系統化工作流程,用於審查使用者介面 (UI) 的可及性。它涵蓋了鍵盤導覽、焦點管理、語義標記、標籤與輸入關聯、錯誤處理、色彩對比度、縮放與重排,以及減少動態行為等關鍵面向。該技能強調使用真實的瀏覽器操作來驗證鍵盤行為,並指出僅靠截圖或腳本化焦點事件並不足以作為可靠的證據。它還指導如何正確計算背景與前景的對比度,特別是在處理複雜背景時。此技能可在各種瀏覽器環境中使用,並鼓勵利用現有的自動化測試工具,但務必記錄測試範圍與結果。它明確將問題分類為封鎖、主要或次要等級,並要求提供修復建議與修復後的重新測試。此審查旨在識別具體的可及性問題,而非宣告全面的 WCAG 合規性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/alty-oss/dev-design/tree/HEAD/skills/accessibility-review

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

可及性審查 是做什麼的?

Português (Brasil)

使用瀏覽器驗證契約檢閱已實作的主要流程與相關的復原狀態。 檢查語義地標/標題、有意義的名稱、標籤/輸入與錯誤關聯、焦點可見性、焦點順序/還原、鍵盤激活與 Escape 行為、對比度、縮放/重排及減少動態行為。

比對受支援的原生鍵盤輸入與可觀察到的焦點/激活變化。一個命名為 press_key 但行為未曾改變的 API 是不夠的。當有文件記載的原生替代方案可用時,請嘗試一種;如果失敗,則標記為不支援;dispatchEvent 與腳本化焦點並非可信的鍵盤證據。對於鍵盤相關的主張,請使用實際的瀏覽器操作。檢查覆蓋層與驗證。僅憑截圖無法證明焦點順序或輔助技術行為。

對於純色背景,請根據實際計算出的前景與背景顏色來計算對比度,包括透明度、繼承與合成;若複雜背景需要,則使用像素分析。記錄方法、顏色、比例與範圍。

若現有的可及性自動化工具可用,請執行;記錄其範圍與結果。請勿僅為了宣稱涵蓋範圍而新增工具依賴。

將問題分類為封鎖/主要/次要,並附上證據與修復建議;修復後重新測試受影響的行為。

將未受支援的檢查記錄為待處理。自動掃描與有限的檢查並不能建立完整的 WCAG 符合性。未經所需審計範圍,請勿宣告全域合規。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能