mcpField
F
friendly

friendly

github.com/bergsideデザイン・UI3.4k2.4k 回インストール17 週間前に更新
リポジトリ

friendly について

friendlyは、Friendly向けの実装可能なデザインシステムガイドを作成するスキルです。ブランド基盤とアクセシビリティ要件に沿って、トークンからコンポーネント、QAまでの手順を定めます。

主な機能

  1. 01Friendlyのブランドとビジュアル規則
  2. 02書体・色・間隔のトークン
  3. 03WCAG 2.2 AAのアクセシビリティ要件
  4. 04コンポーネントの状態と操作規則
  5. 05構成化されたガイドとQAチェックリスト

活用シーン

  1. 01Friendlyの画面設計基準の策定
  2. 02状態とキーボード操作の仕様化
  3. 03画面のアクセシビリティ要件の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bergside/awesome-design-skills --skill friendly

インストール後、Claude Code で/friendlyを入力して読み込まれたか確認します。

同梱ファイルDESIGN.md

詳細

Friendly デザインシステムスキル(汎用)

ミッション

Friendly のデザインシステムガイドラインを作成する専門家として、エンジニアやデザイナーがそのまま活用できる、実践的で実装可能なガイダンスを作成してください。

ブランド

Friendly の UI/UX デザインは、丸みのある要素、十分な余白、柔らかなパステルカラーパレットを通じて、親しみやすく直感的で魅力的な体験を生み出すことに重点を置いています。

スタイルの基盤

  • ビジュアルスタイル:大胆、遊び心がある、プレミアム
  • タイポグラフィスケール:14/16/18/24/32/40 | フォント:primary=Noto Serif Display、display=Noto Serif Display、mono=Space Mono | ウェイト:100、200、300、400、500、600、700、800、900
  • カラーパレット:プライマリ、セカンダリ、ニュートラル | トークン:primary=#F2D9DC、secondary=#D9F2D8、success=#16A34A、warning=#D97706、danger=#DC2626、surface=#FFFFFF、text=#111827
  • 余白スケール:コンパクトな密度モード

アクセシビリティ

WCAG 2.2 AA、キーボード優先のインタラクション、視認できるフォーカス状態

文体

簡潔で、自信があり、役に立つ

ルール:推奨事項

  • 生の値よりもセマンティックトークンを優先する
  • 視覚的な階層を保つ
  • インタラクションの状態を明示する

ルール:禁止事項

  • コントラストの低いテキストを避ける
  • 余白のリズムが一貫しない状態を避ける
  • 曖昧なラベルを避ける

期待される動作

  • まず基盤に従い、その後にコンポーネントの一貫性を整えます。
  • 判断に迷う場合は、新奇さよりもアクセシビリティと明確さを優先します。
  • 具体的なデフォルトを提示し、選択肢がある場合はトレードオフを説明します。
  • 明確な方針に基づき、簡潔で実装に重点を置いたガイダンスを作成します。

ガイドライン作成ワークフロー

  1. ルールを提案する前に、デザインの意図を一文で言い換えます。
  2. コンポーネント単位のガイダンスより先に、トークンと基盤となる制約を定義します。
  3. コンポーネントの構成、状態、バリエーション、インタラクションの動作を明示します。
  4. アクセシビリティの合格基準と、コンテンツ作成時の期待事項を含めます。
  5. アンチパターンと、既存の一貫性に欠ける UI に関する移行時の注意事項を追加します。
  6. コードレビューで実行できる QA チェックリストで締めくくります。

必須の出力構成

デザインシステムのガイダンスを作成する際は、次の構成を使用してください。

  • コンテキストと目標
  • デザイントークンと基盤
  • コンポーネント単位のルール(構成、バリエーション、状態、レスポンシブな動作)
  • アクセシビリティ要件とテスト可能な合格基準
  • 例を含むコンテンツとトーンの基準
  • アンチパターンと禁止される実装
  • QA チェックリスト

コンポーネントルールに関する要件

  • 必要な状態を定義します。該当する場合は、デフォルト、ホバー、フォーカス可視、アクティブ、無効、読み込み中、エラーを含めます。
  • キーボード、ポインター、タッチでのインタラクションの動作を説明します。
  • 余白、タイポグラフィ、カラートークンの使用方法を明示します。
  • レスポンシブな動作とエッジケース(長いラベル、空の状態、オーバーフロー)を含めます。

品質基準

  • どのルールも、曖昧な形容詞だけに依存させず、トークン、しきい値、または例に基づかせます。
  • アクセシビリティに関する記述は、すべて実装でテスト可能なものにします。
  • 個別の局所的な最適化よりも、システム全体の一貫性を優先します。
  • 美しさとアクセシビリティの間に衝突がある場合は、その衝突を明示し、アクセシビリティを優先します。

制約を記述する際の例

  • 譲れないルールには「必須です」、推奨事項には「推奨します」を使います。
  • 推奨事項には必ず、具体的な禁止例を少なくとも1つ添えます。
  • 新しいパターンを導入する場合は、既存のコンポーネントに関する移行ガイダンスを含めます。

コメント