Communitygithub.com

xzedm/clipplic-landing

實作 Google Material Design 3 (Material You) UI 系統。主要支援:Jetpack Compose Material3(MaterialTheme、元件、自適應佈局)。也支援 Flutter 及有限的 Web (@material/web,維護模式)。涵蓋設計權杖、30+ 元件、佈局、主題、M3 Expressive(平台矩陣)與無障礙功能。

clipplic-landing 是什麼?

這項技能會引導你實作 Google 的 Material Design 3(MD3),這是一套個人化、自適應且富有表現力的設計系統。MD3 運用動態色彩、色調表面、圓角造型以及基於彈簧的動態效果,打造出栩栩如生且個人化的使用者介面。 此技能的主要目標平台是 Jetpack Compose(Android),利用 `androidx.compose.material3` 的 `MaterialTheme` 與各種元件。它也支援 Flutter(設定 `useMaterial3: true`)以及網頁技術(使用維護模式中的 `@material/web`)。 內容涵蓋完整的設計權杖系統(色彩、字體排印、形狀、高度、動態)、超過 30 個元件的快速參考(按鈕、文字欄位、對話框、導覽列等),以及如何處理自適應佈局、導航模式和無障礙功能的指引。它也說明了 Google I/O 2026 的最新更新,強調 Compose 優先的開發路徑,並引入了富有表現力的佈局系統、8dp 間距系統和更新後的元件。 當你使用「material design」、「MD3」、「material you」、「Jetpack Compose」或「MaterialTheme」等詞彙時,應優先啟用此技能。它能幫助開發者避開常見陷阱,並確保實作符合 Material Design 3 的官方規範與最佳實務。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/xzedm/clipplic-landing/tree/HEAD/.agents/skills/material-3

在你喜歡的 AI 中提問

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

說明文件

Material Design 3

此技能引導實作 Google 的 Material Design 3(MD3)—— 一套個人化、自適應且富有表現力的設計系統。MD3 使用動態色彩、色調表面、圓角造型及基於彈簧的動態效果,打造出生動且個人化的使用者介面。

核心理念

MD3 奠基於三大原則:

  • 個人化:動態色彩讓 UI 根據使用者的桌布或內容進行調整。主題設定因人而異,非一體適用。
  • 自適應:佈局會根據 5 種視窗尺寸類別進行轉換。元件能因應性地調整大小、重新定位及改變外觀形式。
  • 表現力:造型變化、彈簧物理效果與強調字體排印,在不犧牲可用性的前提下創造令人愉悅的時刻。

最新更新:Google I/O 2026

Material 的 Google I/O 2026 更新 強化了 Compose 優先 的 Android 開發路徑,並擴展了表現力與自適應的指引:

  • Material Android 是 Compose 優先:對於新的 Android 開發工作,優先採用 Jetpack Compose Material3 以獲得最新元件、表現力 API、自適應 Scaffold 以及 Styles API 整合。現有應用程式中可能仍需使用 Android Views,但對於新的 Material 3 實作,不應將其視為預設路徑。
  • 表現力佈局系統:使用表現力佈局 Scaffold,以適配行動裝置、桌面電腦、摺疊裝置、手錶、XR 及其他空間形式的螢幕。應從自適應 Scaffold / 視窗尺寸類別開始,而非固定的手機優先佈局。
  • 8dp 間距系統:應用間距權杖於邊距、內距與間隙,使佈局和元件能根據裝置類型和密度進行程式化調整。
  • 新增/更新的表現力元件:列表、選單、搜尋及搜尋應用程式列已更新表現力指引,並以 Jetpack Compose 為主要實作目標。
  • 手錶與 XR:手錶強調基於物理的動態效果、弧形文字及邊緣貼合容器。XR 則強調空間面板與基於深度的立體感。

與 MD2 的主要差異:

  • 色調表面取代陰影作為主要的深度線索
  • 動態色彩可從單一種子顏色生成完整的配色方案
  • 預設為完全圓角(而非稍微圓角)
  • 基於彈簧的動態物理效果取代了元件固定的緩動曲線
  • 3 個使用者可控的對比度層級(標準 / 中等 / 高)

與前端設計技能之關係: 當兩個技能同時啟用時,MD3 提供設計系統(權杖、元件、佈局規則),而前端設計在這些約束條件下提供創意方向。對於元件結構和權杖使用,MD3 規則具有優先權。注意:Roboto / Roboto Flex 確實是 MD3 中的正確預設字型——前端設計中避免使用 Roboto 的指引在實作 MD3 時不適用。

決策樹

你在建構什麼?

完整應用程式 Scaffold    → 請參閱「常見模式:App Shell」+ references/layout-and-responsive.md
單一元件                 → 請參閱「元件快速參考」表格 → references/component-catalog.md
自訂主題                 → 請參閱 references/theming-and-dynamic-color.md
表單 / 輸入佈局          → 請參閱 references/component-catalog.md § 輸入元件
導覽結構                 → 請參閱 references/navigation-patterns.md
資料顯示                 → 請參閱 references/component-catalog.md § 資料顯示

使用哪個平台?

Jetpack Compose          → 主要:androidx.compose.material3, MaterialTheme, references/*
Flutter                  → 在 ThemeData 中設定 useMaterial3: true, ColorScheme.fromSeed()
網頁 (原生 JS)           → @material/web(有限支援;維護模式)+ CSS 自訂屬性
網頁 (React/Vue/Svelte)   → CSS 自訂屬性 + 包裝元件(無官方 React 函式庫)
網頁 (僅 CSS)            → MD3 權杖值作為 CSS 自訂屬性(不使用 <md-*> 元素)

設計權杖系統

所有 MD3 權杖皆使用 md.sys 命名空間。Jetpack Compose 將角色對應至 MaterialTheme.colorScheme、MaterialTheme.typography 和 MaterialTheme.shapes(與規格相同的語意角色)。在網頁上,這些對應至 CSS 自訂屬性(--md-sys-*):

色彩權杖(--md-sys-color-*)

權杖用途
primary高強調度填色、文字、圖示(位於 surface 上)
on-primary位於 primary 上的文字/圖示
primary-container關鍵元件的突出填色(FAB 等)
on-primary-container位於 primary-container 上的文字/圖示
secondary / on-secondary次要強調色
secondary-container / on-secondary-container退居次要的元件(色調按鈕)
tertiary / on-tertiary對比強調色
tertiary-container / on-tertiary-container互補容器
error / on-error錯誤狀態(靜態——不隨動態色彩改變)
error-container / on-error-container錯誤容器填色
surface預設背景
on-surface任何表面上的文字/圖示
on-surface-variant表面上較低強調度的文字/圖示
surface-container-lowest最低強調度容器
surface-container-low低強調度容器
surface-container預設容器(導覽區域)
surface-container-high高強調度容器
surface-container-highest最高強調度容器
surface-dim / surface-bright在淺色/深色模式下維持相對亮度
inverse-surface / inverse-on-surface / inverse-primary對比元素(Snackbar)
outline重要邊界(文字欄位邊框)
outline-variant裝飾性元素(分隔線)

完整詳細資料:references/color-system.md

字體排印權杖(--md-sys-typescale-*)

尺度尺寸用途
DisplayL / M / S主要文字、大數字
HeadlineL / M / S章節標題
TitleL / M / S較小標題、卡片標題
BodyL / M / S段落文字、描述
LabelL / M / S按鈕、晶片、標題

每種樣式都有以下權杖:-font、-weight、-size、-line-height、-tracking 另外還有 15 種強調變體(更高字重)可透過 --md-sys-typescale-emphasized-* 使用

完整詳細資料:references/typography-and-shape.md

形狀權杖(--md-sys-shape-corner-*)

權杖數值範例元件
none0dp—
extra-small4dp晶片、Snackbar
small8dp文字欄位、選單
medium12dp卡片
large16dpFAB、導覽抽屜
large-increased20dp(表現力)
extra-large28dp對話框、底部工作表
extra-large-increased32dp(表現力)
extra-extra-large48dp(表現力)
full9999px按鈕、晶片、徽章

高度層級

層級DP色調偏移用途
00dp無平面表面、大多數靜止狀態的元件
11dp+5% primary浮起卡片、模態工作表
23dp+8% primary選單、導覽列、滾動後的應用程式列
36dp+11% primaryFAB、對話框、搜尋、日期/時間選擇器
48dp+12% primary(僅 hover/focus 增加)
512dp+14% primary(僅 hover/focus 增加)

在 MD3 中,高度是透過色調表面顏色來傳達,而非陰影。僅在需要防止背景雜亂時才使用陰影。

動態效果

MD3 Expressive(2025 年 5 月)為元件引入了基於彈簧的動態物理效果。舊有的緩動/持續時間系統仍用於轉場(進入/退出/共享軸):

緩動持續時間轉場類型
Emphasized500ms螢幕內開始和結束
Emphasized decelerate400ms進入螢幕
Emphasized accelerate200ms退出螢幕
Standard300ms螢幕內開始和結束(工具類)
Standard decelerate250ms進入螢幕(工具類)
Standard accelerate200ms退出螢幕(工具類)

CSS 緩動值:

  • Emphasized:cubic-bezier(0.2, 0, 0, 1)
  • Emphasized decelerate:cubic-bezier(0.05, 0.7, 0.1, 1)
  • Emphasized accelerate:cubic-bezier(0.3, 0, 0.8, 0.15)
  • Standard:cubic-bezier(0.2, 0, 0, 1)
  • Standard decelerate:cubic-bezier(0, 0, 0, 1)
  • Standard accelerate:cubic-bezier(0.3, 0, 1, 1)

元件快速參考

元件Web 元素主要變體類別
按鈕md-filled-button, md-outlined-button, md-text-button, md-elevated-button, md-filled-tonal-buttonFilled, Outlined, Text, Elevated, Tonal;5 種尺寸(XS–XL);切換動作
按鈕群組md-button-groupStandard, Connected動作
擴展 FABmd-extended-fabSurface, Primary, Secondary, Tertiary動作
FABmd-fabSmall, Medium, Large動作
FAB 選單——動作
圖示按鈕md-icon-button, md-filled-icon-button, md-filled-tonal-icon-button, md-outlined-icon-buttonStandard, Filled, Filled Tonal, Outlined動作
分段按鈕—單選,多選動作
分割按鈕——動作
徽章—Small (dot), Large (count)溝通
載入指示器—Linear, Circular溝通
進度指示器md-linear-progress, md-circular-progressLinear, Circular;確定/不確定溝通
Snackbar—單行,雙行,含動作溝通
工具提示—Plain, Rich溝通
卡片—Filled, Outlined, Elevated容器
輪播—Multi-browse, Uncontained, Hero容器
對話框md-dialogBasic, Full-screen容器
底部工作表—Standard, Modal工作表
側邊工作表—Standard, Modal工作表
分隔線md-dividerFull-width, Inset容器
核取方塊md-checkbox—輸入
晶片md-chip-set, md-assist-chip, md-filter-chip, md-input-chip, md-suggestion-chipAssist, Filter, Input, Suggestion輸入
日期選擇器—Docked, Modal, Range輸入
選單md-menu, md-menu-item—輸入
選項按鈕md-radio—輸入
滑桿md-sliderContinuous, Discrete, Range輸入
開關md-switch含/不含圖示輸入
文字欄位md-filled-text-field, md-outlined-text-fieldFilled, Outlined輸入
時間選擇器—Docked, Modal輸入
頂端應用程式列—置中對齊, Small, Medium, Large導覽
導覽列md-navigation-bar—導覽
導覽抽屜md-navigation-drawerStandard, Modal導覽
導覽軌——導覽
搜尋—Search bar, Search view導覽
分頁標籤md-tabs, md-primary-tab, md-secondary-tabPrimary, Secondary導覽
工具列——導覽
列表md-list, md-list-item單行,雙行,三行資料顯示

注意: Web 元素標示為 — 的元件尚無 @material/web 實作。請對這些元件使用 CSS 自訂屬性搭配標準 HTML。Compose 的對應關係與範例位於 references/component-catalog.md。

含程式碼範例的完整元件詳細資料:references/component-catalog.md

Jetpack Compose(主要)

使用 androidx.compose.material3 搭配 MaterialTheme 和 Material 3 可組合函式(Scaffold、Button、NavigationBar、頂端應用程式列等)。

  • 主題設定:MaterialTheme(colorScheme = …, typography = …, shapes = …)。在 Android 12+ (API 31+) 上想要動態色彩時,建議優先使用 dynamicLightColorScheme / dynamicDarkColorScheme;否則使用 lightColorScheme / darkColorScheme 或從 Material Theme Builder 產生的主題程式碼。
  • 自適應 UI:視窗尺寸類別、列表-詳細資料和支援面板佈局、摺疊裝置——請參閱 references/layout-and-responsive.md 和 references/navigation-patterns.md。
  • 全滿版與邊距:使用 WindowInsets / scaffold 內距來佈局內容,使狀態列和 IME 行為正確——請參閱 references/layout-and-responsive.md。
  • 實驗性 API:部分 Material 3 API 需要使用 @OptIn(ExperimentalMaterial3Api::class) 或表現力功能的 opt-in;請確認你的 BOM 和編譯器版本相符。
MaterialTheme(
    colorScheme = colorScheme, // 來自 dynamicLightColorScheme / lightColorScheme 等
    typography = Typography(),
    shapes = Shapes(),
) {
    // M3 內容 — 建議參閱 references 中的 Scaffold、導覽、文字欄位
}

網頁(有限):@material/web

重要: 根據 Material Design 3 for Web,Material Web Components 處於維護模式,並且M3 Expressive 未在網頁上實作。請在適當時使用 @material/web 建立基於權杖的網頁 UI,但對於目前的 Expressive 功能,請勿將其視為等同於 Compose。

設定

npm install @material/web

個別匯入元件

始終只匯入你使用的元件——匯入整個套件會使套裝軟體膨脹:

// 正確——個別匯入
import '@material/web/button/filled-button.js';
import '@material/web/button/outlined-button.js';
import '@material/web/textfield/outlined-text-field.js';
import '@material/web/icon/icon.js';

// 錯誤——永遠不要這樣做
import '@material/web'; // 匯入所有內容

基本用法

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <link href="https://fonts.googleapis.com/css2?family=Roboto+Flex:wght@400;500;700&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/icon?family=Material+Symbols+Outlined" rel="stylesheet">
</head>
<body>
  <md-filled-button>開始使用</md-filled-button>
  <md-outlined-text-field label="電子郵件" type="email"></md-outlined-text-field>

  <script type="module">
    import '@material/web/button/filled-button.js';
    import '@material/web/textfield/outlined-text-field.js';
  </script>
</body>
</html>

…

[已截斷以進行翻譯]

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

xzedm/clipplic-landing

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

xzedm/clipplic-landing

Material Design 3 and Android platform guidelines. Use when building Android apps with Jetpack Compose or XML layouts, implementing Material You, navigation, or accessibility. Triggers on tasks involving Android UI, Compose components, dynamic color, or Material Design compliance.

xzedm/clipplic-landing

Apple's approach to interface design and fluid, physical motion, translated for the web. Use when building or reviewing gesture-driven UI, spring animations, drag/swipe/sheet interactions, momentum and interruptible transitions, translucent materials and depth, typography (optical sizing, tracking, leading), reduced-motion, or the design foundations (feedback, spatial consistency, restraint) behind Apple-style interfaces.

xzedm/clipplic-landing

Design iOS apps following Apple's Human Interface Guidelines. Generate native components, validate designs, and ensure accessibility compliance for iPhone, iPad, and Apple Watch.

xzedm/clipplic-landing

Redesign mobile app UI to feel unmistakably Apple-like, iOS-forward, and native. Use this skill when building iOS apps, applying Apple Human Interface Guidelines, or creating native-feeling mobile interfaces with SF Pro typography, translucency, and system-like components.

xzedm/clipplic-landing

Accessibility engineering for product interfaces, from focus states and keyboard support to ARIA, forms, and screen readers. Use when building or reviewing UI components, modals, menus, forms, custom widgets, or when the user says "make this accessible" or reports keyboard or screen-reader issues. Triggers on accessibility, a11y, WCAG, aria, focus ring, focus-visible, focus trap, keyboard navigation, tab order, tabindex, screen reader, sr-only, aria-live, alt text, hit area, touch target, prefers-reduced-motion, autoplay, toast duration, skip link, semantic HTML, aria-label, form errors, disabled buttons, "not keyboard accessible".

xzedm/clipplic-landing

OKLCH color space and color usage for web projects. Convert hex/rgb/hsl to oklch, generate palettes, check contrast, handle gamut boundaries, theme with Tailwind v4, and apply color with meaning. Triggers on oklch, color conversion, palette generation, contrast ratio, gamut, display p3, design tokens, semantic color tokens, hue drift, chroma, dark mode colors, accent color, color meaning, light and dark appearance, increased contrast.

xzedm/clipplic-landing

Layout structure for web interfaces, from grouping and alignment to reading order, progressive disclosure, and adaptive breakpoints. Use when structuring a page or component, spacing or aligning controls, deciding what collapses at small sizes, handling RTL layout direction, or reviewing frontend code for layout. Triggers on layout, spacing, alignment, grouping, negative space, whitespace, visual hierarchy, reading order, progressive disclosure, breakpoints, responsive layout, container queries, safe area, full-bleed, edge-to-edge, layout margins, RTL layout, logical properties.

xzedm/clipplic-landing

Web typography from choosing fonts to spacing, wrapping and accessibility. Use when picking or pairing typefaces, configuring variable fonts or OpenType features, setting up a type scale, checking heading hierarchy, styling text in components, truncating text, styling underlines, selection, placeholders or carets, or reviewing frontend code for typography. Triggers on typography, fonts, font formats, woff2, variable fonts, font-weight, opentype, font-feature-settings, letter-spacing, line-height, type scale, heading hierarchy, heading levels, tabular numbers, text-wrap, truncation, line clamp, underlines, text-decoration, text selection, iOS input zoom, scaled input text, font smoothing, text contrast, measure, line length, text-box, smart punctuation, drop cap.

xzedm/clipplic-landing

Design engineering principles for making interfaces feel polished. Use when building UI components, reviewing frontend code, implementing animations, hover states, shadows, borders, micro-interactions, enter/exit animations, choosing or reviewing icons, or any visual detail work. Triggers on UI polish, design details, "make it feel better", "feels off", stagger animations, border radius, optical alignment, image outlines, box shadows, icons, icon stroke weight, icon states, motion restraint.

xzedm/clipplic-landing

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

xzedm/clipplic-landing

Generate developer handoff specs from a design. Use when a design is ready for engineering and needs a spec sheet covering layout, design tokens, component props, interaction states, responsive breakpoints, edge cases, and animation details.

xzedm/clipplic-landing

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

xzedm/clipplic-landing

Extract design primitives from a public website and generate starter token files for your project.

xzedm/clipplic-landing

Use this skill alongside figma-use when the task involves translating an application page, view, or multi-section layout into Figma. Triggers: 'write to Figma', 'create in Figma from code', 'push page to Figma', 'take this app/page and build it in Figma', 'create a screen', 'build a landing page in Figma', 'update the Figma screen to match code', 'convert this modal/dialog/drawer/panel to Figma'. This is the preferred workflow skill whenever the user wants to build or update a full page, modal, dialog, drawer, sidebar, panel, or any composed multi-section view in Figma from code or a description. Discovers design system components, variables, and styles from Code Connect files, existing screens, and library search, then imports them and assembles views incrementally section-by-section using design system tokens instead of hardcoded values.

xzedm/clipplic-landing

**MANDATORY prerequisite**: you MUST invoke this skill BEFORE every `use_figma` tool call. NEVER call `use_figma` directly without loading this skill first. Skipping it causes common, hard-to-debug failures. Trigger whenever the user wants to perform a write action or a unique read action that requires JavaScript execution in the Figma file context, e.g. create/edit/delete nodes, set up variables or tokens, build components and variants, modify auto-layout or fills, bind variables to properties, or inspect file structure programmatically.

xzedm/clipplic-landing

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

xzedm/clipplic-landing

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications.

xzedm/clipplic-landing

Elite UX/UI & Advanced GSAP Motion Engineer. Enforces Python-driven true randomization for layout variance, strict AIDA page structure, wide editorial typography (bans 6-line wraps), gapless bento grids, strict GSAP ScrollTriggers (pinning, stacking, scrubbing), inline micro-images, and massive section spacing.

xzedm/clipplic-landing

Fast headless browser for QA testing and site dogfooding. Navigate pages, interact with elements, verify state, diff before/after, take annotated screenshots, test responsive layouts, forms, uploads, dialogs, and capture bug evidence. Use when asked to open or test a site, verify a deployment, dogfood a user flow, or file a bug with screenshots. (gstack)

相關技能