SuperAPI AI 工具集

swiftui-accessibility-auditor

编程与开发

查看项目

更新于 10-15 21:05

技能介绍

用途:针对 SwiftUI 代码做无障碍审计,适用于 iOS、iPadOS、macOS,聚焦 VoiceOver 与语音反馈、语音控制与切换控制激活、动态字体与文本缩放、焦点与键盘导航(尤其 macOS/iPad)、语义结构(标题、分组、控件)、对比度与非颜色提示、触控目标尺寸(主要 iOS)、减弱动态效果偏好,并尊重 iOS 与 macOS 平台差异。

主要能力:审计可接收单个 SwiftUI 视图文件或片段、界面描述与关键组件、设计约束(如不得改变布局、不得新增依赖、不得重构架构)。输出按优先级分组:P0 阻塞核心任务、P1 显著降低可访问性、P2 低影响改进。每条发现包含问题、影响、确切修复方案与验证步骤,并提供可补丁代码片段、手动测试清单和回归风险说明。

使用方式:输入待审代码或界面说明即可;缺失上下文时假设最简意图并给出替代方案。审查按清单进行,涉及 VoiceOver 语义、自定义控件与手势输入、阅读与文本体验、动态字体、焦点与键盘导航、颜色与对比度、触控目标、动态效果,以及新系统版本就绪评估。可借助 Accessibility Inspector 检查元素树;若存在兼容的 UI 测试目标,可考虑使用 XCUIApplication.performAccessibilityAudit(for:_:) 对代表性界面状态做自动化审计,但自动化不能替代完整辅助技术体验,需报告实际执行与待执行的检查及所用系统设备。

适用场景:审查或修复 SwiftUI 界面的无障碍问题,兼容性检查,发布前无障碍评估等。

限制:不重写整个界面,不做大规模重构,除非存在明确无障碍阻塞;不虚构 API;不破坏布局或修改用户可见文案,除非无障碍需要;需尊重部署目标并标注新 API 可用性;不制造未经验证的发现或补丁。技能内提供的 checklist.md 应按需引用,不应在项目中创建或覆盖。具体版本 1.5.0。功能与收费信息暂未提供。