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。它尤其适合在预合并阶段做 UX 审计、制定整改计划，或者审查应用代码中的可访问性回归问题。

它的不同之处

和通用提示词不同，这个技能把重点放在 WCAG 可追溯性和 SwiftUI 专属整改上。它特别适合那些你不仅想知道“可能哪里有问题”，还想知道“最少改哪些代码”以及“哪些结论可以从源码直接证明、哪些必须人工确认”的场景。

如何使用 swiftui-wcag-accessibility-auditor 技能

安装与加载顺序

对于 swiftui-wcag-accessibility-auditor install，请使用仓库里的安装命令：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 这种用法在你提供明确的功能范围、屏幕路径和待检查代码片段时效果最好。比如可以这样描述：“审计 AuthView.swift 以及相关视图中的 SwiftUI 登录流程，检查是否存在 WCAG 2.2 A/AA 问题，返回 P0/P1/P2 修复项，并把代码中无法证明的内容标记为 Needs user verification。” 同时把自定义控件、错误状态或导航路径也一并提供给技能，方便它完整追踪。

建议工作流

一个实用的 swiftui-wcag-accessibility-auditor guide 流程是：先定义功能流，再检查入口视图和下游状态，识别语义钩子和高风险模式，最后把发现映射到状态和整改优先级。如果代码无法证明某些行为，例如 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。这个顺序能帮助你在请求修复之前先理解审计规则，从而同时提升发现质量和补丁质量。

swiftui-wcag-accessibility-auditor 技能 FAQ

这只适用于 SwiftUI 吗？

是的，swiftui-wcag-accessibility-auditor skill 是围绕原生 SwiftUI iOS 功能构建的。如果功能里还包含 UIKit、混合实现细节或自定义平台桥接，它仍然可能有帮助，但结论确定性会更低，也会更依赖人工确认。

它和普通提示词有什么不同？

普通提示词可以给出泛化的可访问性建议。这个技能更偏向决策导向：它遵循代码审计工作流，只基于代码进行判断，使用 WCAG 2.2 加 WCAG2Mobile 的框架，并偏好带证据的状态和最小化 SwiftUI 补丁。对于需要可追溯性和控制修改范围的 UX Audit 工作来说，这种方式更合适。

适合新手吗？

适合，只要你能把它指向某个屏幕或功能即可。你不需要掌握所有 WCAG 条款，但需要提供足够的上下文，让技能定位到正确的流程。输入越具体，它越不容易把问题泛化成空泛结论。

什么情况下不该用它？

如果你想做的是运行模拟器测试、视觉 QA，或者不以 SwiftUI 为中心的泛移动端可访问性审查，就不适合用它。它也不适合只想要一个不带 WCAG 可追溯性的快速启发式判断；这种情况下，更轻量的 SwiftUI 审查技能会更合适。

如何改进 swiftui-wcag-accessibility-auditor 技能

把范围切得更窄

效果最好的 swiftui-wcag-accessibility-auditor usage 输入，会明确一个流程、一到两个文件，以及一个任务结果。比如，“检查密码重置页面及其错误状态”就比“审计整个应用”更好。范围越窄，技能越容易把真正的阻塞项和低价值观察区分开。

把最难的情况提前说清楚

如果页面用了仅图标按钮、自定义手势、覆盖层、sheet、校验提示横幅、对 Dynamic Type 敏感的布局，或者依赖键盘操作的表单，请直接说明。这些正是 swiftui-wcag-accessibility-auditor for UX Audit 最容易产出有价值结论的地方；缺少上下文时，质量下降也最明显。

要求证据和可直接修改的修复

请明确要求输出包含代码证据、WCAG 映射，以及最小化的整改片段。这样可以把技能引导到可直接打补丁的结果，而不是抽象建议。如果需要第二轮，再让它优先处理未解决的 Needs user verification 项，或最高优先级的 P0 和 P1 问题。

从审计迭代到补丁

第一轮结束后，把已接受的发现反馈回去，再让它对剩余代码做第二轮细化。这是提升结果质量最快的方法：技能可以收紧整改建议、减少误报，并把不确定区域转成具体的人工检查项，而不是泛泛而谈。