mcpField
A
android-material3-design-system

android-material3-design-system

github.com/krutikjain设计与 UI14191 次安装31 周前更新
代码仓库

关于 android-material3-design-system

android-material3-design-system 是面向 Android 应用的 Material 3 设计技能,涵盖设计令牌与界面模式。它为 Compose、View 系统及混合界面提供一致性、适配性和无障碍设计指导。

主要功能

  1. 01颜色、字体和间距的 Material 3 令牌
  2. 02Compose、View 与混合界面指导
  3. 03自适应组件选择
  4. 04无障碍与边缘情况检查
  5. 05主题归属与状态管理指导

适用场景

  1. 01为 Compose 屏幕应用 Material 3 主题
  2. 02让 XML 与 Compose 界面保持视觉一致
  3. 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.yaml
references/
official-links.md
patterns.md
scenarios.md
scripts/
run_examples.sh

详细介绍

Android Material3 设计系统

适用场景

  • 当请求涉及以下内容时,使用此技能:Android Material3 主题、Compose 设计系统令牌、Android 字体排版与颜色系统。
  • 主要目标:在 Android 应用中应用 Material 3 令牌、颜色、字体、间距、自适应组件和主题所有权。
  • 扩展范围时交接给以下技能:
  • android-compose-foundations
  • android-compose-accessibility

工作流

  1. 确定目标界面属于 Compose、View 系统,还是混合互操作界面。
  2. 选择能满足响应式、无障碍和性能需求的最低成本 UI 模式。
  3. 围绕稳定状态、明确的副作用和可复用的设计令牌构建 UI。
  4. 在测试应用中检验长文本、字体缩放、RTL 和窄屏设备等边缘情况。
  5. 交接前通过单元测试、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