Communitygithub.com

デザインシステム

デザインシステム、スタイルガイド、トークンセットの開始、コンポーネントやトークンの追加・変更、バラバラになった画面の標準化、ガイド内の色のばらつきや欠陥状態・仕様不一致の監査に使用します。

デザインシステム とは?

このスキルは、デザインシステムの構築・変更・監査を体系的に進めるためのアシスタントです。決定を一度行い、それをあらゆる場所で再利用できるようにします。すべての色はトークン化され、インタラクティブな要素はすべての状態を表示し、変更はその要素を使用するすべての画面に波及します。基盤(カラーロール、タイプスケール、スペーシングなど)から階層的に構築し、各層で承認を得ることを推奨します。監査はレポートを作成するだけで、自動修正は行いません。Claude Code、Cursor、Codex、GitHub Copilotなど、コードエディタと連携するAIエージェント向けに設計されており、FigmaなどのデザインツールアダプターやHTMLでの実装もサポートしています。プロジェクトのルートにある`DESIGN.md`を尊重し、既存のガイドルールを優先します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/design-skills/tree/HEAD/skills/design-system

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

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

ドキュメント

デザインシステム は何をしますか?

概要

デザインシステムとは、決定を一度行い、それをあらゆる場所で再利用するための場所です。すべての色はトークンであり、すべてのインタラクティブな要素はすべての状態を表示し、変更はその要素を使用するすべての画面に反映されます。基盤から階層的に構築し、各層で承認を得てから次に進みます。監査はレポートを作成し、自動修正は行いません。

使用するタイミング

  • 「…のスタイルガイド/デザインシステム/トークンを開始する」
  • コンポーネント、バリアント、またはトークンを追加する、または既存のものを変更する。
  • 「これらの画面を一貫させる」、「標準化する」、「ガイドを監査する」、または画面内のばらばらの色や使い捨ての部品。

使用しないタイミング

  • 1つの値に関する質問(「主要な色は何ですか?」):その質問に答える。
  • 共有部品に対する、ユーザーが正確に記述した小さな編集(1つの値、1つのラベル、1つのサイズ):定義された場所で1回だけ変更し、影響を受ける画面を伝える。状態マトリックスや中断はなし。

開始前

  1. プロジェクトルートに DESIGN.md が存在する場合は読む:それはプロジェクトのデザインブリーフです。
  2. 既存のものを確認する:トークン、ガイド、コンポーネント、画面、コード。既存のガイドが外観を優先します。 以下のデフォルトと異なる場合でも、そのルールに従い、その違いを一度だけ伝える。
  3. 使用ツールのアダプターを references/adapters/ から選択する(paper.md、figma.md、html.md)。アダプターがない場合は、ツールで同じアクションを実行し、手動でマッピングしたことを伝える。デザインツールがまったくない場合は、HTML(html.md)で構築する。画像のみしかない場合は、そこから読み取った値は推定値であることを伝える。
  4. モードを決定する:作成、追加または変更、または監査。

手順 · 作成

  1. 基盤のドラフト:

    • カラーロール(トークンロール)
    • タイプスケール
    • スペーシング
    • 半径
    • シャドウ(最大2つ)
    • レイアウト幅
    • モーション時間
    • 短い「執筆方法」セクション

    トークンは役割で命名する(text-muted、border-hover、danger-bg)。値のみで命名しない(gray-500)。

  2. インタラクションルール(1回だけ): 枠線ありの要素、枠線なしの要素、プライマリアクションについて、ホバー、プレス、フォーカス(キーボードのみ)、無効、ローディング、選択済みの見た目を記述する。コンポーネントはこれらのルールに従い、独自のルールを発明しない。

  3. 一時停止し、ユーザーに基盤とインタラクションルールを見せる。 まだコンポーネントを構築しない。

  4. 最初の画面で必要な順に、コンポーネントを1つずつ処理する。 各コンポーネントは、コンポーネントアナトミーを備えたガイドセクションを持つ:ルールとその理由を示す凡例、例、およびバリアント×状態の状態マトリックス。各コンポーネントをコンポーネントインデックスに追加する。

手順 · 部品の追加または変更

  1. 既存のコンポーネントとそのバリアントで対応できるか確認する。使い捨てよりも再利用を優先する。
  2. アナトミーを使用して描画し、完全な状態マトリックスを含める。新しい色、サイズ、アイコンは、後回しにせず、今トークンまたはアイコンセットエントリにする。
  3. その部品を使用するすべての画面とコードの場所をリストアップする。
  4. 一時停止し、ユーザーに変更内容とそのリストを見せる。
  5. 承認後、波及させる:
    • リスト上のすべての画面を更新する
    • コードがあれば更新する
    • コンポーネントインデックスを更新する
    • 何がどこで変更されたかを報告する

手順 · 監査

  1. 監査チェックリストをガイド、画面、コード(ある場合)に対して実行する。
  2. レポートを作成する:重要度順に並べた発見事項。それぞれに、問題の場所、重要である理由、提案された修正を含める。
  3. 一時停止し、ユーザーにレポートを見せる。ユーザーがどの修正を行うか指示するまで、ファイルを変更しない。 元のファイルのコピーを保存しても、それらの編集が許容されるわけではない。

ルール

確定的(あらゆるプロジェクト):

ルール理由
すべての色はトークンである;画面やコード内にばらばらの16進数値は禁止ばらばらの値はニアデュープに漂流し、誰も一度に変更できなくなる
アイコンセットは1つ混合セットは混合製品のように見える
デザインとコードは同時に変更し、デザインが優先そうしないと、1週間以内にガイドが真実でなくなる
すべてのインタラクティブな要素には状態マトリックスがある画面ごとにアドホックに描画された状態は決して一致しない
共有部品への変更は、波及する前に影響を受ける画面とともにリストアップするそうしないと、1つの「小さな」変更が20の画面を静かに再デザインする

デフォルト(既存のガイドがあればそれを優先):

デフォルト理由
ホバー時、枠線ありの要素は枠線のみを暗くするカードやフィールドの背景が変わると重く感じる
ホバーは選択済みよりも控えめにするホバーが選択済みのように見えると、2つのものが選択されていると思われる
選択してもフォントの太さは変わらない太さが変わるとテキストの幅が変わる
プレースホルダーはマutedテキストよりも明るくするそうしないと、プレースホルダーが入力テキストのように読める
積み重ねリストやメニューのアイテム間には小さな間隔を設け、接触させない接触するハイライトが1つのブロックにまとまる
フォーカスリングはキーボードからのみ表示するマウスクリック後のリングはバグのように見える
ローディング時は要素の正確なサイズを維持するレイアウトシフトを防ぐ
シャドウはフローティング要素(メニュー、ポップオーバー、ダイアログ、トースト)にのみ、2段階の強度で使用するシャドウが至る所にあると、作成しようとした階層が平坦になる
1画面につきプライマリアクションは最大1つ2つのプライマリは、画面が決定を下していないことを意味する

完了条件

  • 作成: 基盤とインタラクションルールが承認されている。各コンポーネントにアナトミー、状態マトリックス、インデックス行がある。
  • 変更: リストアップされたすべての画面とコードの場所が更新され、インデックスが更新されている。
  • 監査: 優先順位付けされたレポートが提出され、ファイルは変更されていない。

よくある間違い

考え現実
「トークンと10のコンポーネントを一度にガイド全体を構築しよう」承認されていない基盤の上に10のコンポーネントを作ると、10回の作り直しになる。基盤、中断、そしてコンポーネント。
「監査で問題が見つかったから、すぐに修正しよう」ユーザーは修正の半分に同意しないかもしれない。レポート、中断、ユーザーが選んだものだけを修正。
「元のファイルをバックアップフォルダに保存したから、修正しても安全だ」バックアップがあっても、ユーザーが修正に同意するわけではない。まずレポート。
「ボタンにホバーと無効があれば十分だ」状態マトリックスには、すべての状態×すべてのバリアントが必要:通常、ホバー、プレス、フォーカス、無効、ローディング、選択済み。
「--teal-600 はトークンだ」それは値です。コンポーネントには役割(--color-primary)が必要で、そうすれば値を1か所で変更できる。
「この画面には少し異なるカードが必要だ」それをカードのバリアントにするか、カードを使用する。使い捨ては漂流の始まりだ。

関連スキル