Communitygithub.com

Material 3 表達式技能

設計、實作、現代化與審查生產環境介面,採用 Material 3 與 Material 3 表達式。當任務提及 Material Design 3、M3 表達式、Material You、表達式 UI、Material 元件或主題設定、適應性 Material 佈局,或 Material 焦點的無障礙/設計審查時使用。

Material 3 表達式技能 是什麼?

這是一個專為 AI 代理設計的技能,用於建立行為一致且符合 Material 3 表達式規範的產品介面,而非僅模仿其表面風格。它擴展了 Material 3,加入了基於研究的主題設定、元件、動畫、字體排版與視覺表達選項,但保留 Material 3 的基礎。此技能強調「任務優先於裝飾」、「語意優先於炫技」與「有理由的表達」,所有表達選擇都必須提升層級、辨識度、回饋或情緒清晰度。它支援 Android、Wear OS、Flutter、Web 等多平台,並要求考慮無障礙、在地化、各種輸入模式與狀態(如載入、錯誤、成功、停用等)。該技能遵循明確的工作流程,從檢查專案、理解產品、建立結構層級,到應用 M3 基礎、進行有意的表達、選擇元件、設計適應性視窗、定義互動回饋,最後實作與驗證。它提供參考文件路由表,可依任務需要載入對應文件,例如設計基礎、表達原則、元件模式、適應性佈局、無障礙指南等。最終成果需通過品質檢查,包括主要任務與行動可辨識、語意基礎而非任意裝飾、表達有特定目的、介面在各種尺寸與輸入模式下仍可使用,以及所有狀態與失敗路徑都已考慮。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Material 3 表達式

使用此技能來建立行為一致、宛若一個協調的 Material 產品介面,而非僅模仿其表面風格的螢幕。

Material 3 表達式是 Material 3 的擴展。它加入了基於研究的選項,用於主題設定、元件、動畫、字體排版與視覺表達。它並未取代 Material 3 的基礎。保留熟悉的語意,並運用表達讓重要資訊、操作與狀態更易於察覺。

無妥協原則

  • 任務優先於裝飾。 在設定樣式之前,請先了解使用者、任務、資訊架構、內容優先順序與互動方式。
  • 語意優先於炫技。 使用正確的元件來完成工作。絕不偽裝導航、操作、選取或破壞性行為。
  • 有理由的表達。 每個表達選擇都必須改善層級、辨識度、回饋或情緒清晰度。
  • 平台真實性。 不要發明 API、元件可用性、權杖或版本需求。原生功能在 Android、Wear OS、Flutter、Web 與其他平台上有所不同。
  • 完整的行為。 指定有意義的載入、空白、錯誤、成功、停用、聚焦、懸停、按下與選取狀態。
  • 預設無障礙。 為輔助技術、足夠的對比、文字縮放、鍵盤與指標輸入、減少動畫、在地化與從右到左佈局進行設計。
  • 維護程式碼庫。 檢查現有架構與慣例。不要因附帶的設計工作而遷移框架、取代程式庫或升級相依項目。

工作流程

除非使用者明確縮小任務範圍,否則請依序列執行。

1. 檢查專案並確定目標

識別框架、平台、現有的 Material 程式庫與版本、主題設定、導航、可重複使用的元件、狀態管理方法、建置/測試命令與目前的設計慣例。

僅釐清會實質改變架構的限制條件。否則,請做出保守的假設並簡要說明。絕不要假設 UI 程式庫支援新發布的 M3 表達式功能:請先查看官方 API 與版本說明。

2. 理解產品

捕捉:

  • 主要使用者、目標與成功操作。
  • 螢幕或流程邊界與資訊層級。
  • 內容密度、資料關係與重要決策。
  • 品牌限制與允許的視覺變更程度。
  • 支援的裝置、視窗大小、方向與輸入方法。
  • 所需狀態、失敗路徑、權限與破壞性操作。
  • 無障礙、在地化、隱私與效能限制。

當結構化的簡報有幫助時,請使用設計簡報。

3. 建立結構與層級

分組相關內容,區分導航與操作,並識別主要操作。在選擇顏色、角落形狀或動畫之前,先選擇資訊佈局。偏好少量清晰的區域,而非一堆巢狀卡片。

4. 應用 M3 基礎

定義語意色彩角色、字體排版、形狀、高度、間距與圖示使用,作為一個一致的系統。支援淺色與深色主題;在平台支援且使用者或品牌需求允許的情況下,考慮動態色彩。請閱讀設計基礎。

5. 進行有意的表達傳遞

當表達槓桿能強化任務時,使用其中一項或少數幾項:

  • 大小與元件靈活性以建立優先順序。
  • 形狀以區分角色、群組或有意義的狀態。
  • 色彩以集中注意力並傳達語意意義。
  • 字體排版以建立層級與特色。
  • 容器以釐清群組並隔離重要操作。
  • 動畫以解釋原因、連續性、狀態變化或空間關係。

不要最大化每個槓桿。例行設定、表單、密集資料與長篇閱讀畫面通常需要節制。請閱讀表達原則。

6. 選擇元件與模式

根據使用者意圖與平台支援來選擇元件,而非根據新穎性。在滿足需求時,優先選擇官方元件。僅在真正有缺口時使用自訂元件,並保留預期的語意、狀態與互動行為。請閱讀元件與模式。

7. 為可用視窗設計

根據應用程式視窗調整導航、窗格數量、層級與資訊密度,而非僅根據裝置標籤。在相關時支援調整大小、折疊/展開轉換、方向變更、鍵盤使用與大型顯示器。請閱讀適應性佈局。

8. 定義互動、回饋與動畫

指定狀態轉換、回饋時機、聚焦行為、錯誤復原與取消。動畫應傳達狀態變化或空間關係;提供減少動畫的替代方案。請閱讀動畫與回饋。

9. 為實際平台實作

預設使用最小且正確的相依項目集合與穩定的 API。清楚標記實驗性 API,並在採用前解釋其取捨。應用平台指南中的平台特定說明。

10. 在交接前驗證

執行相關的專案檢查,並審查每個要求的狀態、視口、輸入模式、主題、語言方向與無障礙行為。不要報告未執行的檢查。使用審查清單與實作工作流程。使用範本提供簡潔的交接。

參考文件路由

僅載入目前任務所需的參考文件:

任務閱讀
任何 M3 表達式設計決策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 表達式對等性。

相關技能