A

android-compose-accessibility

android-compose-accessibility

github.com/krutikjain设计与 UI1484 次安装31 周前更新

关于 android-compose-accessibility

android-compose-accessibility 是用于审查和改进 Android Compose 界面无障碍体验的技能。它指导开发者检查语义、播报、对比度、焦点顺序和触控目标，并验证不同设备与字体缩放场景。

主要功能

01审查 Compose 无障碍体验
02配置语义与屏幕播报
03检查对比度和焦点顺序
04适配触控目标与布局
05验证字体缩放和 RTL

适用场景

01审查 Compose 界面的无障碍体验
02修复语义或焦点顺序问题
03检查窄屏布局和大字号
04在示例应用中验证无障碍改动

安装

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

$npx skills add https://github.com/krutikjain/android-agent-skills --skill android-compose-accessibility

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

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/

openai.yaml

references/

official-links.md

patterns.md

scenarios.md

scripts/

run_examples.sh

详细介绍

Android Compose 无障碍功能

适用场景

当请求涉及以下内容时使用此技能：Compose 无障碍审查、Compose 中的 Android 语义问题、Compose 中的焦点顺序。
主要目标：通过语义、播报、对比度、焦点顺序和自适应触控目标，让 Compose 界面更易于访问。
当范围扩大时，移交给以下技能：
android-ui-states-validation
android-testing-ui

工作流

确认目标界面属于 Compose、View 系统，还是混合互操作界面。
选择能够满足响应能力、无障碍功能和性能需求且实现成本最低的 UI 模式。
围绕稳定状态、明确的副作用和可复用的设计令牌构建 UI。
在示例应用中测试长文本、字体缩放、RTL 和窄屏设备等边界情况。
移交前通过单元测试、UI 测试和适合截图验证的检查进行验证。

注意事项

在添加动画或抽象之前，优先确保状态稳定、渲染可预测。
默认遵循无障碍语义、对比度、焦点顺序和触控目标指南。
未明确划定互操作边界时，不要混合 Compose 和 View 系统的所有权。
优先进行基于测量的性能优化，避免过早进行微优化。

反模式

将导航或业务逻辑直接嵌入叶级 UI 组件。
使用固定尺寸，导致本地化或动态文本无法正常显示。
忽略语义，只播报视觉变化。
不调整思维模式，直接将 XML 模式移植到 Compose。

示例

顺利完成

场景：为 Compose OrbitTasks 卡片添加语义和易读标签。
命令：cd examples/orbittasks-compose && ./gradlew :app:connectedDebugAndroidTest

边界情况

场景：在窄屏布局中验证字体缩放、对比度和触控目标。
命令：cd examples/orbittasks-compose && ./gradlew :app:assembleDebug

故障恢复

场景：区分无障碍请求与一般 UI 验证或主题相关工作。
命令：python3 scripts/eval_triggers.py --skill android-compose-accessibility

完成检查清单

实现路径明确、精简，并针对正确的 Android 界面类型。
已运行或更新相关示例命令和基准测试提示词。
当请求涉及相邻技能时，已记录移交事项。
官方参考资料涵盖所选模式，以及主要的迁移或故障排查路径。

官方参考资料

评论

支持 Markdown

登录后评论