swiftui-wcag-accessibility-auditor

swiftui-wcag-accessibility-auditor 技能總覽

這個技能做什麼

swiftui-wcag-accessibility-auditor 技能會針對 SwiftUI iOS 功能程式碼做無障礙稽核，依據 WCAG 2.2 Level A/AA 與 WCAG2Mobile 解讀來檢查，並以精簡、按優先順序排列的格式輸出可直接套用的修補建議。它是為原始碼審查而設計，不是執行時測試，所以能幫你找出可能的阻礙、追溯證據，並把需要使用者驗證的項目明確標示出來，而不是靠猜測。

誰適合使用

當你需要針對 SwiftUI 無障礙做檢查時，swiftui-wcag-accessibility-auditor skill 很適合用在 auth、表單、設定、清單、自訂控制項或 modal 流程等畫面。對於在合併前做 UX audit、規劃修正工作，或檢查 App 程式碼是否出現無障礙回歸的團隊來說，它特別實用。

它有什麼不同

和一般通用提示不同，這個技能把重心放在 WCAG 可追溯性與 SwiftUI 專屬修正上。當你不只想知道哪裡可能有問題，還想知道要用最小的程式碼改動改什麼，以及哪些發現能從原始碼直接證明、哪些需要人工確認時，它尤其有幫助。

如何使用 swiftui-wcag-accessibility-auditor skill

安裝與載入順序

若要執行 swiftui-wcag-accessibility-auditor install，請使用 repo 的安裝指令：npx skills add ramzesenok/iOS-Accessibility-Audit-Skill --skill swiftui-wcag-accessibility-auditor。安裝完成後，請先閱讀 references/ios-audit-workflow.md，接著看 references/ios-audit-checklist.md，最後再看 references/wcag2mobile-ios-reference.md，先建立驅動稽核的標準脈絡。

什麼輸入最容易得到好結果

swiftui-wcag-accessibility-auditor usage 這種用法在你提供明確的功能範圍、畫面路徑和要檢查的程式碼片段時效果最好。舉例來說：：「Audit the SwiftUI sign-in flow in AuthView.swift and related views for WCAG 2.2 A/AA issues, return P0/P1/P2 fixes, and mark anything not provable in code as Needs user verification.」也請附上技能需要追蹤的自訂控制項、錯誤狀態或導覽流程。

建議的工作流程

實用的 swiftui-wcag-accessibility-auditor guide 流程是：先定義功能流，再檢查入口 view 與後續狀態，找出語意錨點與高風險模式，最後把發現對應到狀態與修正優先順序。如果程式碼無法證明 VoiceOver 輸出、焦點順序或視覺對比之類的行為，技能就不應直接宣稱通過，而應要求做針對性的使用者驗證。

先讀哪些檔案

先從 SKILL.md 開始，接著檢視 references/ios-audit-workflow.md、references/ios-audit-checklist.md、references/swiftui-remediation-guide.md、references/swiftui-manual-checklist.md 和 references/ios-accessibility-api-examples.md。這個順序能幫你在要求修正前先理解稽核規則，進而提升發現品質與 patch 品質。

swiftui-wcag-accessibility-auditor skill 常見問題

這只適用於 SwiftUI 嗎？

是的，swiftui-wcag-accessibility-auditor skill 是以原生 SwiftUI iOS 功能為核心設計。如果功能還包含 UIKit、混合實作細節，或自訂平台橋接，這個技能仍可能有幫助，但你應該預期判定會比較不確定，且需要更多使用者驗證。

這和一般提示有什麼不同？

一般提示可以產出較通用的無障礙建議。這個技能則更偏向決策導向：它採用純程式碼稽核流程，使用 WCAG 2.2 加上 WCAG2Mobile 的框架，並偏好帶有證據的狀態與最小化的 SwiftUI 修補。對需要重視可追溯性與變更範圍的 UX Audit 工作來說，它更合適。

對新手友善嗎？

可以，只要你能把它對準某個畫面或功能就行。你不需要把每一條 WCAG 條文都背熟，但你必須提供足夠的上下文，讓技能找到正確流程。你的輸入越具體，它就越不容易過度泛化。

什麼情況下不該用它？

如果你想做的是即時模擬器測試、視覺 QA，或是不以 SwiftUI 為核心的廣泛行動裝置無障礙檢查，就不要用它。當你只想要快速的經驗判斷、又不需要 WCAG 可追溯性時，它也不適合；這種情況下，較輕量的 SwiftUI review skill 會更合適。

如何改進 swiftui-wcag-accessibility-auditor skill

把功能切得更窄

最強的 swiftui-wcag-accessibility-auditor usage 輸入，通常會同時明確寫出一條流程、一到兩個檔案，以及一個任務結果。例如，Review the password reset screen and its error states 會比 audit the app 更好。範圍越窄，技能越能把真正的阻礙和低價值觀察分開。

先把最難的情境講清楚

如果畫面用了只有圖示的按鈕、自訂手勢、overlay、sheet、驗證提示列、對 Dynamic Type 敏感的版面，或鍵盤驅動表單，請一開始就說明。這些正是 swiftui-wcag-accessibility-auditor for UX Audit 最能產出有價值發現的區域；缺少這些上下文時，結果品質掉得最快。

要求證據與可直接修改的層級修補

請它輸出帶程式碼證據、WCAG 對應關聯，並附上最小修正片段的發現。這會把技能推向可直接套用的 patch 輸出，而不是抽象建議。如果你需要下一輪，請它先聚焦在尚未解決的 Needs user verification 項目，或最高優先的 P0 與 P1 問題。

從稽核迭代到修補

第一輪完成後，把你接受的發現回饋給它，並要求對剩餘程式碼做第二輪精煉。這是提升結果品質最快的方法：技能可以收斂修正方向、移除誤判，並把不確定區域轉成具體的人工檢查，而不是籠統建議。