Communitygithub.com

Material 3 Expressive

借助 Material 3 和 Material 3 Expressive 设计、实现、现代化改造和审查生产级界面。当任务涉及 Material Design 3、M3 Expressive、Material You、表达性 UI、Material 组件或主题、自适应 Material 布局,以及以 Material 为核心的可访问性/设计审查时使用。

Material 3 Expressive 是什么?

此技能旨在帮助开发者和设计师创建行为一致、符合 Material Design 理念的界面,而非仅模仿其表层视觉风格。Material 3 Expressive 是 Material 3 的扩展,提供了基于研究的主题化、组件、动效、排版和视觉表达选项,但不会取代 M3 的基础规范。技能强调“任务优先于样式”、“语义优先于华丽”等核心原则,并提供了从项目检查、产品理解、结构搭建、基础应用、表达性设计到组件选择、窗口适配、动效反馈、平台实现和最终验证的完整工作流程。它支持 Android、Wear OS、Flutter、Web 等多平台,要求遵循平台 API 与版本现状,并内置了丰富的参考文献指南,帮助用户在设计决策、主题、组件、动效、自适应布局、无障碍和国际化等方面做出明智选择。技能还设定了质量门槛,确保设计结果可理解、可访问、语义正确且符合平台实际能力。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asimawdah/material-expressive-skill/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Material 3 Expressive 是做什么的?

使用此技能创建行为连贯的 Material 产品界面,而非仅仅模仿其表面样式的屏幕。

Material 3 Expressive 是 Material 3 的扩展。它增加了基于研究的主题化、组件、动效、排版和视觉表达选项。它不会取代 Material 3 的基础规范。保留熟悉的语义,使用表达性手段使重要信息、操作和状态更易于感知。

不可妥协的原则

  • 任务优先于样式。 在样式设计之前,先理解用户、任务、信息架构、内容优先级和交互方式。
  • 语义优先于华丽。 使用正确的组件完成工作。切勿伪装导航、操作、选择或破坏性行为。
  • 有理由的表达。 每个表达性选择都必须改善层次结构、可识别性、反馈或情感清晰度。
  • 平台真实性。 不要虚构 API、组件可用性、令牌或版本要求。原生功能在不同平台(Android、Wear OS、Flutter、Web 等)上存在差异。
  • 完整的行为。 明确指定加载中、空状态、错误、成功、禁用、聚焦、悬停、按下和选中等状态。
  • 默认无障碍。 为辅助技术、足够对比度、文字缩放、键盘和指针输入、减少动效、本地化和从右到左布局而设计。
  • 保护现有代码库。 检查现有架构和约定。不要将框架迁移、库替换或依赖升级作为附带的设计工作。

工作流程

除非用户明确缩小任务范围,否则遵循以下顺序。

1. 检查项目并确定目标

确定框架、平台、现有的 Material 库和版本、主题设置、导航、可复用组件、状态管理方法、构建/测试命令以及当前的设计约定。

只澄清那些会实质性地改变架构的约束。否则,做出保守的假设并简要说明。切勿假设某个 UI 库支持新发布的 M3 Expressive 功能:首先查看官方 API 和发布说明。

2. 理解产品

捕获以下信息:

  • 主要用户、目标和成功操作。
  • 屏幕或流程边界以及信息层次结构。
  • 内容密度、数据关系和重要决策。
  • 品牌约束以及允许的视觉变化程度。
  • 支持的设备、窗口尺寸、方向以及输入方式。
  • 必需的状态、失败路径、权限和破坏性操作。
  • 无障碍、本地化、隐私和性能约束。

当结构化摘要有帮助时,请使用设计摘要。

3. 建立结构和层次结构

将相关内容分组,区分导航和操作,并确定主要操作。在选择颜色、圆角形状或动画之前,先选择信息布局。优先使用少量清晰的区域,而不是一堆嵌套的卡片。

4. 应用 M3 基础

将语义化颜色角色、排版、形状、高度、间距和图标使用定义为一个连贯的系统。支持浅色和深色主题;在平台支持且用户或品牌要求允许的情况下,考虑动态颜色。阅读设计基础。

5. 进行有意的表达性处理

当表达性杠杆有助于强化任务时,使用一个或几个:

  • 大小和组件灵活性来确定优先级。
  • 形状来区分角色、组或有意义的状态。
  • 颜色来集中注意力并传达语义含义。
  • 排版来创建层次结构和风格。
  • 容器来澄清组并隔离重要操作。
  • 动效来解释原因、连续性、状态变化或空间关系。

不要最大化每个杠杆。常规设置、表单、密集数据和长阅读页面通常需要克制。阅读表达性原则。

6. 选择组件和模式

根据用户意图和平台支持来选择组件,而非新颖性。当官方组件满足需求时,优先使用它们。仅在存在真正缺口时才使用自定义组件,并保留预期的语义、状态和交互行为。阅读组件和模式。

7. 为可用窗口设计

根据应用程序窗口(而不仅仅是设备标签)调整导航、面板数量、层次结构和信息密度。在相关时支持调整大小、折叠/展开过渡、方向变化、键盘使用和大屏幕显示。阅读自适应布局。

8. 定义交互、反馈和动效

指定状态转换、反馈时机、聚焦行为、错误恢复和取消。动效应传达状态变化或空间关系;提供减少动效的替代方案。阅读动效和反馈。

9. 为实际平台实现

默认使用最小且正确的依赖集和稳定 API。明确标记实验性 API 并在采用前解释其权衡。应用平台指南中的平台特定说明。

10. 在移交前验证

运行相关的项目检查,并审查每个必需的状态、视口、输入模式、主题、语言方向和无障碍行为。不要报告未实际运行的检查。使用审查清单和实现工作流程。使用模板提供简洁的移交文档。

参考导航

仅为当前任务加载所需的参考:

任务阅读
任何 M3 Expressive 设计决策references/expressive-principles.md
主题、颜色、排版、形状、高度、间距references/design-foundations.md
选择或组合组件references/components-and-patterns.md
动画、过渡、加载、反馈references/motion-and-feedback.md
手机、平板、折叠屏、桌面或可穿戴设备适配references/adaptive-layouts.md
无障碍、RTL、本地化、输入支持references/accessibility-and-internationalization.md
特定框架的实现references/platform-guidance.md
端到端交付和验证references/implementation-workflow.md
审核已完成的设计references/review-checklist.md
当前 API、版本或源码问题references/official-sources.md

质量标准

结果满足以下条件时才算准备就绪:

  1. 用户无需解释即可识别主要任务和操作。
  2. 设计使用语义化的 Material 基础,而非随意装饰。
  3. 表达性处理有特定目的,而非均匀应用。
  4. 界面在支持的尺寸和输入模式下仍然可理解且可用。
  5. 考虑了所有有意义的状态和失败路径。
  6. 无障碍和本地化是实现的一部分,而非事后润色。
  7. API 和依赖版本已核实,移交文档说明了实际测试的内容。

当项目无法满足某个要求时,请指出限制并提供最安全的平台适当替代方案。切勿在平台不提供的情况下声称完全兼容 Material 3 Expressive。

相关技能