关于 flutter-accessibility
flutter-accessibility 是一项用于审查和落实 Flutter 项目无障碍要求的技能。它涵盖辅助导航、文字缩放、对比度、本地化和动态效果,并要求报告区分自动检查与人工验证。
主要功能
- 01审查语义信息与辅助导航
- 02测试文字缩放和对比度
- 03检查本地化与 RTL 布局
- 04优先使用原生语义控件
- 05报告验证结果与缺口
适用场景
- 01发布前审查 Flutter 应用
- 02检查键盘与屏幕阅读器操作流程
- 03测试翻译及双向界面
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ musabekisakov-imj/ flutter-design-engineer --skill flutter-accessibility安装后在 Claude Code 中输入/flutter-accessibility确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/accessibility-and-localization.mdconnected-product-workflows.md详细介绍
Flutter 无障碍功能
阻碍核心任务的无障碍问题应视为发布阻断项。
审查
- 确定核心用户旅程,以及受支持平台上相关的辅助模式。
- 检查语义、标签、值、提示、分组、标题、实时更新和装饰性内容的排除情况。
- 在可用情况下,使用键盘、类似开关的焦点导航和屏幕阅读器进行遍历。
- 将系统文字缩放测试至受支持的最大值,确保内容不会被裁切,关键操作也不会被隐藏。
- 验证对比度、非颜色提示、触控目标、错误关联、禁用状态的清晰度,以及对动态效果偏好的支持。
- 测试较长的译文、复数形式、双向内容、镜像导航和方向性图标是否正确。
- 阅读
references/accessibility-and-localization.md以及项目中已有的相关平台指南。 对于多领域仪表板,阅读references/connected-product-workflows.md,并确保语义顺序与跨领域的视觉优先级一致。
实施
- 优先使用 Flutter 原生语义控件,而非自定义手势界面。
- 有意识地合并或排除语义,避免重复播报。
- 让焦点顺序与视觉顺序和任务顺序保持一致。
- 播报异步错误和重要状态变更,但避免过多提示。
- 布局需要镜像时,使用逻辑方向 API(
start/end)。 - 不要为了适配脆弱的布局而禁用文字缩放。
- 提供减少动态效果的行为,同时保留必要的反馈。
验证与报告
说明测试过的工具、平台、文字缩放级别、语言区域、阅读方向、主题和用户旅程。区分自动化检查与辅助技术的手动验证,并指出尚未覆盖的部分。
评论
支持 Markdown