mcpField
A
axiom-ios-accessibility

axiom-ios-accessibility

github.com/charleswiltgen设计与 UI1.2k203 次安装今天更新
代码仓库

关于 axiom-ios-accessibility

axiom-ios-accessibility 将 iOS 无障碍任务引导至 axiom-accessibility-diag 技能或自动审计 Agent，帮助开发者处理常见问题并准备审核。

主要功能

  1. 01将无障碍问题转至诊断技能
  2. 02涵盖 VoiceOver 和 Dynamic Type
  3. 03检查对比度与触控目标
  4. 04提供自动审计路径
  5. 05涵盖 Assistive Access 和 WCAG

适用场景

  1. 01排查 VoiceOver 标签与提示
  2. 02检查 Dynamic Type 实现
  3. 03准备无障碍审核
  4. 04发起自动无障碍扫描

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/charleswiltgen/axiom --skill axiom-ios-accessibility

安装后在 Claude Code 中输入/axiom-ios-accessibility确认已加载。

详细介绍

iOS 无障碍路由器

任何无障碍相关工作都必须使用此技能，包括 VoiceOver、动态字体、颜色对比度和 WCAG 合规性。

适用场景

在以下情况下使用此路由器：

  • 修复 VoiceOver 问题
  • 实现动态字体
  • 检查颜色对比度
  • 确保触控目标尺寸符合要求
  • 为 App Store 无障碍审核做准备
  • 执行 WCAG 合规性审计
  • 支持辅助访问（认知障碍，iOS 17+）

路由逻辑

无障碍问题

所有无障碍相关工作 → /skill axiom-accessibility-diag

  • VoiceOver 标签和提示
  • 动态字体缩放
  • 颜色对比度（WCAG）
  • 触控目标尺寸
  • 键盘导航
  • 减弱动态效果支持
  • 辅助访问（认知障碍，iOS 17+）
  • 使用无障碍检查器
  • 为 App Store 审核做准备
自动扫描

无障碍审计 → 启动 accessibility-auditor Agent 或运行 /axiom:audit accessibility（扫描 VoiceOver 问题、动态字体违规、颜色对比度不达标问题和 WCAG 合规性）

决策树

  1. 遇到任何无障碍问题 → accessibility-diag
  2. 想要自动执行无障碍扫描？→ accessibility-auditor（Agent）

避免自我说服

想法事实
"等我把功能都做完再添加 VoiceOver 标签"无障碍是基础，而非润色。accessibility-diag 可避免应用被 App Store 拒绝。
"我的应用不需要无障碍功能"所有应用都需要无障碍功能。这是 App Store 指南的要求，也能让所有用户受益。
"动态字体只需使用 .scaledFont"动态字体有 7 种常见违规情况。accessibility-diag 会一一检查。
"我觉得颜色对比度没问题"仅凭视觉判断并不可靠。WCAG 对比度比例需要测量。accessibility-diag 会进行验证。

关键模式

图像无障碍
  • 纯装饰性图像使用 Image(decorative: "photo") — VoiceOver 会自动忽略此图像（等效于 accessibilityHidden(true)，但语义更明确）
  • 对标签复杂或会变化的按钮使用 accessibilityInputLabels() — 提供备用标签，提高语音控制的准确性
  • 遵循 accessibilityDifferentiateWithoutColor 环境值 — 启用时，除颜色指示外，还应提供非颜色线索（图标、图案、标签）
accessibility-diag 覆盖范围
  • 8 项关键无障碍问题（包括辅助访问）
  • WCAG 合规等级（A、AA、AAA）
  • 辅助访问模式（认知障碍，iOS 17+）
  • 无障碍检查器工作流
  • VoiceOver 测试清单
  • App Store 审核要求

调用示例

用户："我的按钮没有被 VoiceOver 读出来" → 调用：/skill axiom-accessibility-diag

用户："如何支持动态字体？" → 调用：/skill axiom-accessibility-diag

用户："检查我的应用是否存在无障碍问题" → 调用：/skill axiom-accessibility-diag

用户："为 App Store 无障碍审核做准备" → 调用：/skill axiom-accessibility-diag

用户："自动扫描我的应用是否存在无障碍问题" → 调用：accessibility-auditor Agent

用户："如何支持辅助访问？" → 调用：/skill axiom-accessibility-diag

用户："我的应用没有显示在辅助访问中" → 调用：/skill axiom-accessibility-diag

评论

支持 Markdown