Communitygithub.com

Material 3 エクスプレッシブ

Material 3 および Material 3 Expressive を用いて、本番インターフェースの設計、実装、最新化、レビューを行います。タスクに Material Design 3、M3 Expressive、Material You、エクスプレッシブ UI、Material コンポーネントやテーマ設定、アダプティブ Material レイアウト、あるいは Material に焦点を当てたアクセシビリティ/デザインレビューが含まれている場合に使用します。

Material 3 エクスプレッシブ とは?

このスキルは、Material 3 を基盤としながら、テーマ設定、コンポーネント、モーション、タイポグラフィ、視覚表現において研究に基づいた拡張オプションを提供する Material 3 Expressive を活用して、一貫性のある Material 製品のように振る舞うインターフェースを作成するためのものです。単にスタイルを模倣するのではなく、ユーザー、タスク、情報アーキテクチャを優先した上で、表現手段を用いて重要な情報やアクション、状態の知覚を向上させます。このスキルは、プロジェクト調査、表現意図の設計、適切なコンポーネント選択、アダプティブレイアウト、モーション設計、実装、検証に至るまでのワークフローを段階的に提供し、Claude Code や Cursor などの AI エージェントが Material 3 関連の開発を効率的かつ高品質に進めることを支援します。各段階で参照すべきドキュメントが明確に定義されており、アクセシビリティとローカライゼーションを設計の一部として組み込むことも求められます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/asimawdah/material-expressive-skill/tree/HEAD

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Material 3 エクスプレッシブ は何をしますか?

このスキルを使用して、一貫性のある 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. 意図的な表現パスを作成する

タスクを強化する場合に、1つまたは少数の表現レバーを使用します:

  • サイズとコンポーネントの柔軟性で優先順位を確立する。
  • 形状で役割、グループ、意味のある状態を区別する。
  • 色で注意を集中させ、セマンティックな意味を伝える。
  • タイポグラフィで階層と個性を生み出す。
  • 包含関係でグループを明確にし、重要なアクションを分離する。
  • モーションで原因、連続性、状態変化、空間関係を説明する。

すべてのレバーを最大化しないでください。日常的な設定、フォーム、高密度データ、長い読書面では、通常は抑制が必要です。表現原則 を参照してください。

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 のパリティを主張してはいけません。

関連スキル