关于 android-accessibility
用于检查 Android Compose 界面与组件无障碍性的技能，涵盖屏幕阅读器、键盘焦点和触控交互，适合开发者审查界面实现。
主要功能
- 01图像与图标描述检查
- 0248x48dp 触控目标检查
- 03WCAG AA 对比度检查
- 04焦点顺序与语义检查
- 05标题及状态播报
适用场景
- 01审查图像描述是否恰当
- 02检查按钮触控区域大小
- 03评估自定义开关状态播报
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/android-accessibility确认已加载。
详细介绍
Android 无障碍检查清单
说明
请从以下无障碍方面分析提供的组件或屏幕。
1. 内容描述
- 检查：
Image和Icon可组合项是否具有有意义的contentDescription？ - 装饰性元素：如果图片纯粹用于装饰，请使用
contentDescription = null。 - 可操作元素：如果某个元素可点击，其描述应说明操作（例如“播放音乐”），而不是图标（例如“三角形”）。
2. 触控目标尺寸
- 标准：所有交互元素的最小尺寸为 48x48dp。
- 修复：如果视觉图标较小，请使用
MinTouchTargetSize，或将其放入带有适当内边距的Box中。
3. 颜色对比度
- 标准：WCAG AA 要求普通文本的对比度为 4.5:1，大号文本/图标的对比度为 3.0:1。
- 工具：使用对比度逻辑检查颜色与背景的对比度。
4. 焦点与语义
- 焦点顺序：确保键盘/屏幕阅读器的焦点按逻辑顺序移动（例如从左上到右下）。
- 分组：对于复杂项目（例如包含文本和图标的行），使用
Modifier.semantics(mergeDescendants = true)，使其作为单个项目播报。 - 状态描述：如果标准语义不足以描述自定义状态，请使用
stateDescription描述这些状态（例如“已选中”“已勾选”）。
5. 标题
- 遍历：为标题文本标记
Modifier.semantics { heading() }，以便屏幕阅读器用户可以在各个章节之间跳转。
Agent 使用示例提示词
- “分析此
Image的内容描述。它是否恰当？” - “检查此按钮的触控目标尺寸是否至少为 48dp。”
- “此自定义切换按钮是否会向 TalkBack 报告其‘已勾选’状态？”
评论
支持 Markdown