mcpField
S
spacious

spacious

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

spacious について

spaciousは、デザイナーやエンジニア向けの汎用デザインシステムスキルです。余白を重視した基盤を、アクセシビリティ確認と構造化されたQAを含む実装可能なガイドにまとめます。

主な機能

  1. 01余白を重視したビジュアル基盤
  2. 02Open Sans、Montserrat、IBM Plex Monoの書体
  3. 038ポイントのスペーシンググリッド
  4. 04WCAG 2.2 AAのアクセシビリティ指針
  5. 05コンポーネント状態とレスポンシブルール
  6. 06構造化されたQAチェックリスト

活用シーン

  1. 01一貫したコンポーネント仕様の作成
  2. 02キーボードとスクリーンリーダー対応の確認
  3. 03レスポンシブ表示やエラー状態の設計

インストール

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

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

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

同梱ファイルDESIGN.md

詳細

Spacious Design System Skill(Universal)

ミッション

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

ブランド

Spacious の UI/UX デザインでは、ゆとりのある余白、一貫したパディング、4 または 8 ポイントのグリッドシステムを用いて、すっきりと読みやすく、直感的に操作できるインターフェースを実現します。

スタイルの基礎

  • ビジュアルスタイル:ミニマル、クリーン
  • 文字サイズのスケール:12/14/16/18/24/30/36|フォント:primary=Open Sans、display=Montserrat、mono=IBM Plex Mono|ウェイト:100、200、300、400、500、600、700、800、900
  • カラーパレット:primary、neutral、success、warning、danger|トークン:primary=#3B82F6、secondary=#8B5CF6、success=#16A34A、warning=#D97706、danger=#DC2626、surface=#FFFFFF、text=#111827
  • 余白のスケール:8pt ベースラインのグリッド

アクセシビリティ

WCAG 2.2 AA、キーボード優先のインタラクション、視認できるフォーカス状態、ARIA よりもセマンティック HTML を優先、スクリーンリーダーでテスト済みのラベル、動きを抑える設定への対応、44px 以上のタッチターゲット、ハイコントラストへの対応

執筆トーン

簡潔、自信のある、親切、明快、親しみやすい、プロフェッショナル、行動を促す、専門用語を抑える

ルール:推奨事項

  • 生の値よりもセマンティックトークンを優先する
  • 視覚的な階層を維持する
  • インタラクションの状態を明確にする
  • 空、読み込み中、エラーの状態に対応する
  • デフォルトでレスポンシブな動作を保証する
  • アクセシビリティに関する根拠を文書化する

ルール:禁止事項

  • コントラストの低いテキストを避ける
  • 一貫性のない余白のリズムを避ける
  • 目的のない装飾的な動きを避ける
  • 曖昧なラベルを避ける
  • 複数の視覚的なメタファーを混在させない
  • アクセシビリティに配慮していないヒット領域を避ける

期待される動作

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

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

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

必須の出力構成

デザインシステムのガイダンスを生成する際は、次の構成を使用します。

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

コンポーネントルールの要件

  • 必須の状態を定義します:default、hover、focus-visible、active、disabled、loading、error(該当する場合)。
  • キーボード、ポインター、タッチでのインタラクションの動作を説明します。
  • 余白、タイポグラフィ、カラートークンの使い方を明示します。
  • レスポンシブな動作と、長いラベル、空の状態、オーバーフローなどのエッジケースを含めます。

品質ゲート

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

制約を記述する際の例

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

コメント