accessibility-compliance

概覽

什麼是 accessibility-compliance？

accessibility-compliance 是一項實用技能，專為需要實作、稽核或維護無障礙使用者介面的前端開發者設計。它聚焦於 WCAG 2.2 指南、ARIA 模式、鍵盤導覽、螢幕閱讀器支援及行動裝置無障礙。此技能協助確保您的網頁或 React 專案能被所有人使用，包括身心障礙者。

誰適合使用此技能？

• 建置或重構 UI 元件的前端工程師
• 目標達成 WCAG 2.2 AA 或 AAA 等級的團隊
• 需要新增 ARIA 角色、狀態與屬性的開發者
• 負責無障礙稽核或包容性設計的任何人

解決的問題

• 確保介面可感知、可操作、易理解且具韌性
• 提供實用的 ARIA 模式與行動無障礙技術
• 協助您為鍵盤、螢幕閱讀器及觸控使用者打造體驗
• 支援符合法律與組織無障礙標準

使用方式

安裝步驟

1. 使用以下指令將技能加入您的代理或專案：

   npx skills add https://github.com/wshobson/agents --skill accessibility-compliance
   

2. 從 SKILL.md 檔案開始，了解 accessibility-compliance 的功能與工作流程概覽。

3. 閱讀輔助檔案以掌握實作細節：

   • references/aria-patterns.md：ARIA 角色、狀態與屬性，附 React 範例
   • references/mobile-accessibility.md：行動裝置觸控目標大小、間距及螢幕閱讀器支援
   • references/wcag-guidelines.md：WCAG 2.2 原則、符合等級與程式碼範例

適應您的專案

• 將提供的模式作為參考，而非直接套用。依您的程式碼庫與 UI 框架調整 ARIA、鍵盤導覽及行動無障礙技術。
• 在開發流程中整合無障礙檢查，特別是在建置自訂元件或表單時。
• 使用真實輔助技術（如 VoiceOver、TalkBack、NVDA）及鍵盤導覽進行測試。

何時使用 accessibility-compliance

• 進行無障礙稽核或修正問題時
• 建置具包容性設計的新 UI 元件時
• 確保行動與桌面端無障礙一致性時
• 達成組織或法律的無障礙要求時

常見問題

accessibility-compliance 涵蓋哪些內容？

此技能涵蓋 WCAG 2.2 指南、ARIA 模式、鍵盤導覽、焦點管理、無障礙表單、行動觸控目標及螢幕閱讀器支援。提供 React 與網頁專案的程式碼範例與最佳實踐。

我應該從哪裡開始？

建議先閱讀 SKILL.md 以獲得概覽，接著探索 references/ 資料夾中的詳細模式與程式碼範例。特別推薦 references/aria-patterns.md 與 references/mobile-accessibility.md，適合實作參考。

這個技能只適用於 React 嗎？

雖然許多範例使用 React，但其原則與模式適用於任何前端框架或純 HTML/JS 專案。

這個技能能保證符合 WCAG 嗎？

不能。accessibility-compliance 提供指導與模式，您仍需依照實際情況調整並測試。務必與真實使用者及輔助技術驗證。

我在哪裡可以找到更多資源？

請查看 references/ 資料夾中的精選指南與程式碼範例。欲查看完整檔案清單，請開啟 Agent Skills Finder 的 Files 分頁。