关于 android-material3-design-system
android-material3-design-system 是面向 Android 应用的 Material 3 设计技能,涵盖设计令牌与界面模式。它为 Compose、View 系统及混合界面提供一致性、适配性和无障碍设计指导。
主要功能
- 01颜色、字体和间距的 Material 3 令牌
- 02Compose、View 与混合界面指导
- 03自适应组件选择
- 04无障碍与边缘情况检查
- 05主题归属与状态管理指导
适用场景
- 01为 Compose 屏幕应用 Material 3 主题
- 02让 XML 与 Compose 界面保持视觉一致
- 03检查长文本、RTL 和字体缩放下的布局
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ krutikjain/ android-agent-skills --skill android-material3-design-system安装后在 Claude Code 中输入/android-material3-design-system确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/official-links.mdpatterns.mdscenarios.mdscripts/run_examples.sh详细介绍
Android Material3 设计系统
适用场景
- 当请求涉及以下内容时,使用此技能:Android Material3 主题、Compose 设计系统令牌、Android 字体排版与颜色系统。
- 主要目标:在 Android 应用中应用 Material 3 令牌、颜色、字体、间距、自适应组件和主题所有权。
- 扩展范围时交接给以下技能:
android-compose-foundationsandroid-compose-accessibility
工作流
- 确定目标界面属于 Compose、View 系统,还是混合互操作界面。
- 选择能满足响应式、无障碍和性能需求的最低成本 UI 模式。
- 围绕稳定状态、明确的副作用和可复用的设计令牌构建 UI。
- 在测试应用中检验长文本、字体缩放、RTL 和窄屏设备等边缘情况。
- 交接前通过单元测试、UI 测试和便于截图的检查进行验证。
护栏
- 在添加动画或抽象之前,优先确保状态稳定、渲染可预测。
- 默认遵循无障碍语义、对比度、焦点顺序和触控目标指南。
- 未明确划定互操作边界时,不要混合 Compose 和 View 系统的所有权。
- 优先采用有测量依据的性能优化,避免过早进行微优化。
反模式
- 将导航或业务逻辑直接嵌入叶子 UI 组件。
- 使用会因本地化或动态文本而失效的固定尺寸。
- 忽略语义,仅播报视觉变化。
- 将 XML 模式直接移植到 Compose,而不调整思维模型。
示例
顺利流程
- 场景:为 Compose 展示界面应用一致的 Material 3 主题。
- 命令:
cd examples/orbittasks-compose && ./gradlew :app:assembleDebug
边缘情况
- 场景:在混合 UI 迁移期间保持 XML 和 Compose 界面的视觉一致。
- 命令:
cd examples/orbittasks-xml && ./gradlew :app:assembleDebug
故障恢复
- 场景:避免将主题令牌相关工作转交给无障碍或通用 Compose 基础技能。
- 命令:
python3 scripts/eval_triggers.py --skill android-material3-design-system
完成检查清单
- 实现路径明确、精简,并针对正确的 Android 界面。
- 已执行或更新相关示例命令和基准测试提示词。
- 请求涉及相邻技能时,已记录交接事项。
- 官方参考资料涵盖所选模式以及主要迁移或故障排查路径。
官方参考资料
评论
支持 Markdown