开发与工程 swiftuiiosaccessibilitywcag-22code-auditvoiceoverstatic-analysis

SwiftUI WCAG 无障碍审计技能

对 SwiftUI iOS 代码做 WCAG 2.2 A/AA 无障碍审计,输出按优先级分组、可直接套用的修复补丁。

FollowSkills 评估 · FSRS-2.0
推荐
58/ 100 五分制 2.9 / 5
1 2 3 4 5 6
1信任安全20 / 25 · 4.0/5

该技能是纯静态代码审计,不执行应用、不修改文件、无网络依赖或数据外发,最小权限与只读定位明确;强制标记『Needs user verification』防止过度断言,安全姿态良好。扣分点:无显式回滚/确认机制说明、发布者身份未经验证,许可证元数据缺失,故未给满分。

2可靠稳定9 / 20 · 2.3/5

指令自洽性高:加载顺序、状态词汇表、严格输出模板、静态证据边界规则一致且互相引用无矛盾;rg 搜索命令具体可复现。扣分点:静态评审无法执行验证关键路径,references 文件的实际存在性与内容一致性未验证,异常输入下的失败反馈质量只能从文档推断,受静态上限约束。

3适用触发12 / 15 · 4.0/5

适用场景定义清晰:原生 iOS SwiftUI 审计,明确排除 macOS/watchOS/Web/UIKit主导场景,并给出邻近技能的分流规则,触发语义(示例请求、描述)精确,语义调用支持良好。扣分点:无中文支持说明(输出语言未声明),WCAG2Mobile 草案依赖引入一定不确定性。

4规范维护7 / 15 · 2.3/5

文档分层良好:SKILL.md + 六个 references 渐进披露,含目录、非目标、优先级模型、手动检查清单。扣分点:许可证未知、无版本号/变更日志、维护责任与更新路径未声明;wcag2mobile 参考文件暴露作者本地绝对路径(/Users/romanmirzoyan/...),溯源不完整且不够专业。

5有效结果6 / 15 · 2.0/5

README 提供了一个看起来完整、可直接使用的真实审计报告样例(含 P1 发现、WCAG 映射、补丁级代码片段、用户跟进检查),核心任务(代码审计+修复建议)在结构上可完成。扣分点:样例输出未经独立执行验证,补丁正确性(如 accessibilityAction 用法)无法静态确证,比较优势证据有限,受静态上限 7 约束。

6证据核验4 / 10 · 2.0/5

证据组织良好:每个发现要求引用文件路径、符号、WCAG SC 映射,区分规范标准(WCAG 2.2)与信息性解读(WCAG2Mobile),并明确区分事实与推断。扣分点:核心源文件 wcag_doc.md 指向作者本地路径无法独立核实,无第三方执行证据、无测试套件或 CI 覆盖关键路径,静态评审上限 5 且证据类型单一。

证据充分度: 评估于 2026年9月10日 审查版本 8214fbf61e3a
使用前请注意
  • 许可证元数据缺失,企业合规使用前需确认授权条款。
  • 参考文件引用作者本地绝对路径,WCAG2Mobile 源文件无法独立核实,标准解读的溯源链不完整。
  • 静态评审未执行:审计质量与补丁正确性仅基于文档和 README 样例推断,建议先在真实代码库试运行验证。
  • 无版本号、变更日志与维护责任声明,长期可用性存在不确定性。
  • 未声明中文支持;输出语言需使用者自行确认。
  • WCAG2Mobile 为信息性草案(多处为占位/WIP),技能已妥善标注但使用者不应将其视为规范性符合标准。
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

这是一个面向 iOS 开发者的 Agent Skill,指导 AI 以纯代码审查的方式审计 SwiftUI 界面是否满足 WCAG 2.2 Level A/AA 及移动端解释规范。它不运行应用,而是逐条给出问题、WCAG 条款编号、置信度标注和最小改动的 Swift 代码补丁,并把无法从代码判定的事项列为需人工验证的后续检查。报告为严格格式的 Markdown,按 P0/P1/P2 优先级分组。仓库附带六份参考文档,覆盖审计流程、检查清单、WCAG2Mobile 解释、SwiftUI API 示例、修复策略和人工验证清单。

读取仓库中的 SwiftUI 视图源码,使用 rg 等命令检索 accessibility 修饰符、手势、Dynamic Type 相关模式;对照 WCAG 2.2 成功标准清单逐项记录证据与状态;生成包含问题定位(文件+行号)、WCAG 条款映射、patch-ready Swift 代码片段和置信度的优先级分组 Markdown 报告;对代码无法判定的事项输出'需用户验证'的后续检查项。

  1. iOS 开发者在发布前审计 SwiftUI 结账流程,需要符合 WCAG 2.2 的优先级排序问题清单
  2. 团队审查 SwiftUI 登录 + OTP 流程,确认满足无障碍认证标准 3.3.8
  3. 维护含自定义手势任务列表的应用,需检查 VoiceOver/Switch Control 的角色与语义暴露
  4. 开发者在 Toast 提示仅靠视觉/触觉反馈时,需按 4.1.3 状态消息标准补齐 VoiceOver 播报
  5. 审计团队需要把 iOS 修复点对应到具体 WCAG 条款以便合规留痕

这个 Skill 有哪些优点和局限?

优点
  • 问题与 WCAG 2.2 具体条款(含 WCAG2Mobile 移动端解释)一一对应,便于合规追溯
  • 输出 patch-ready 的最小 Swift 代码改动,而非抽象建议
  • 诚实标注置信度,代码无法判定的事项明确列为人工验证项而非臆断
  • 报告格式严格统一(P0/P1/P2 分组、代码内嵌),易于直接进入代码评审
局限
  • 仅支持 SwiftUI 原生代码;核心行为依赖 UIKit 时需改用配套的 mobile-accessibility-audit 技能
  • 纯静态审计,不运行应用——对比度、VoiceOver 实际播报时机等仍需人工验证
  • 不覆盖 macOS、watchOS 或跨平台框架
  • 仓库未标注开源许可证,商业使用前需与作者确认
  • README 未展示自动化测试或其他用户的验证证据

如何安装这个 Skill?

从 https://github.com/ramzesenok/iOS-Accessibility-Audit-Skill 克隆仓库,将 skill 文件夹(含 SKILL.md 与 references/ 目录)放入你的 Agent Skills 目录。具体的安装路径与客户端配置方式在源材料中未说明,请参照你所使用的平台的 Agent Skills 文档。

如何使用这个 Skill?

在支持 Agent Skills 的客户端中用类似以下提示触发:'Use $swiftui-wcag-accessibility-auditor to audit this SwiftUI checkout feature against WCAG 2.2 and return prioritized findings with patch-ready fixes.' 指定要审计的 SwiftUI 视图或功能文件;技能会输出按 P0/P1/P2 分组、内嵌代码片段的报告,以及(如有)需人工验证的后续检查清单。

这个 Skill 与同类方案有什么区别?

SKILL.md 自身指出了两个相邻技能:mobile-accessibility-audit(适合含 UIKit 或只需标准覆盖优先的审计)和 swiftui-accessibility-auditor(快速 SwiftUI 启发式审查、不需 WCAG 条款追溯时更合适)。本技能是两者的合并定位。

常见问题

它会直接帮我修代码吗?
不会自动修改。它输出 patch-ready 的代码片段和建议,由开发者决定是否应用;README 明确说明'提供审计而非修复'。
审计结果可信度如何?
这是纯代码静态审计,不运行应用。每条发现标注置信度,代码无法判定的事项(如 VoiceOver 实际播报)会明确列为'需用户验证'并给出具体人工检查步骤。
我的应用混用了 UIKit 怎么办?
只有当 UIViewRepresentable 等桥接影响 SwiftUI 功能时才会部分审计。若核心行为委托给 UIKit,技能会建议改用 mobile-accessibility-audit 技能。
是否需要网络或特殊工具?
技能正文引用的搜索命令依赖 rg(ripgrep)和本地文件读取;审计本身是本地静态分析,无需网络调用或额外服务。

相关 Skills