ghost-ui-skills

Ghost UI Skills

AI エージェントを使って Ghost スタイルのインターフェースを構築するための、独自の制約です。

適用する場面

以下の場合にこれらのガイドラインを参照してください。

• ダークモードのインターフェースを構築する場合
• Ghost をイメージしたデザインシステムを作成する場合
• Inter フォントと 4px グリッドを使って UI を実装する場合

色

• MUST 主要なサーフェスには暗い背景（明度 < 20）を使うこと — 検出された明度：8
• MUST ページの背景（surface-base）に #FFFFFF を使うこと
• SHOULD カラーパレットを縮小すること（現在 18 色を検出）
• MUST アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に保つこと

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#FFFFFF	rgb(255,255,255)	ページの背景
surface-raised	#DAE1EC	rgb(218,225,236)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#0D0E10	rgb(13,14,16)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#D8D9DC	rgb(216,217,220)	見出し、本文テキスト
text-secondary	#333437	rgb(51,52,55)	セカンダリテキスト、控えめなテキスト
text-tertiary	#4C4E53	rgb(76,78,83)	補足テキスト
border-default	#DBE0E8	rgb(219,224,232)	控えめな境界線、区切り線
warning	#FAB429	rgb(250,180,41)	警告状態、注意

タイポグラフィ

• MUST 主要なフォントファミリーに Inter を使うこと
• SHOULD 一貫性のため、単一のフォントファミリーを使うこと
• MUST 主要な見出しには 73px / 700 を使うこと
• MUST 本文テキストには 26px / 500 を使うこと
• SHOULD フォントウェイトを減らすこと（現在 5 種を検出）
• MUST 見出しには text-balance、本文テキストには text-pretty を使うこと
• SHOULD 数値データには tabular-nums を使うこと
• NEVER 明示的に要求されない限り、文字間隔を変更しないこと

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	73px	700	#1E2826	1
body	Inter	26px	500	#2F2F2F	1
body-secondary	Inter	24px	semi_bold	#D8D9DC	2
body-secondary	Inter	23px	semi_bold	#E5E6E9	1
text-18px	Inter	18px	semi_bold	#C2C3C4	1
text-14px	Inter	14px	400	#7B7B7B	1
text-14px	Inter	14px	400	#7C7C7C	1
text-14px	Inter	14px	400	#787878	1
text-13px	Inter	13px	400	#313234	1
text-13px	Inter	13px	400	#333438	1

タイポグラフィの参照

フォントファミリー：

• Inter（42 回使用）

フォントサイズ： 9px, 10px, 11px, 12px, 13px, 14px, 18px, 23px, 24px, 26px, 73px

間隔

• MUST 間隔には 4px グリッドを使うこと
• SHOULD 次のスケールから間隔を選ぶこと：1px, 2px, 3px, 4px, 5px, 6px, 7px, 8px
• SHOULD 要素間のデフォルトの間隔に 65px を使うこと
• NEVER 任意の間隔の値を使わないこと（デザインスケールを使うこと）
• SHOULD コンテナー内のパディングを一貫させること

境界線

• MUST 次のスケールから境界線の角丸を選ぶこと：3px, 4px, 7px, 13px, 16px
• SHOULD 境界線の幅を次に限定すること：1px, 6px
• SHOULD デフォルトの境界線の角丸に 13px を使うこと
• NEVER 任意の境界線の角丸の値を使わないこと（デザインスケールを使うこと）
• SHOULD 要素を区切るために控えめな境界線（1px）を使うこと

角丸の参照

スケール： 3px, 4px, 7px, 13px, 16px

レイアウト

• MUST 基準のビューポート幅を 1920px としてデザインすること
• SHOULD 要素の幅を一貫させること：260px, 10px, 8px, 13px, 35px
• SHOULD テキスト中心のレイアウトを保ち、明確な階層を設けること
• NEVER h-screen を使わず、ビューポートの高さ全体には h-dvh を使うこと
• MUST 固定要素では safe-area-inset を考慮すること
• SHOULD 正方形の要素には w-* + h-* の代わりに size-* を使うこと

検出されたレイアウトパターン

• メインコンテンツ：幅：1635px、高さ：1080px

コンポーネント

ボタン

バリアント	背景	テキスト	境界線	高さ	角丸
Ghost	透明	#757678	なし	-	-

インタラクティブ状態

フォーカス

• MUST アクセントカラー（#5E6AD2）を使った 2px のアウトラインを使うこと
• MUST 2px のアウトラインオフセットを使うこと
• NEVER フォーカスインジケーターを削除しないこと

ホバー

• ボタン（プライマリ）：背景を10％明るくします
• ボタン（セカンダリ）：背景色に #DAE1EC を使用します
• リスト項目：背景色に #DAE1EC を使用します

無効状態

• MUST opacity: 0.5 を使用します
• MUST cursor: not-allowed を使用します

インタラクション

• 破壊的または取り消し不可能な操作には、MUST AlertDialog を使用します
• ローディング状態には、SHOULD 構造的なスケルトンを使用します
• エラーは操作が行われる場所の近くに表示します（MUST）
• input または textarea 要素での貼り付けを、NEVER ブロックしません
• アイコンのみのボタンには aria-label を追加します（MUST）

アニメーション

• 明示的に要求されていない限り、NEVER アニメーションを追加しません
• MUST コンポジターのプロパティ（transform、opacity）のみをアニメーションさせます
• NE​VER レイアウトのプロパティ（width、height、top、left、margin、padding）をアニメーションさせません
• 入場アニメーションには ease-out を使用します（SHOULD）
• インタラクションのフィードバックは 200ms を超えないようにします（NEVER）
• prefers-reduced-motion を尊重します（SHOULD）

パフォーマンス

• 大きな blur() または backdrop-filter のサーフェスをアニメーションさせません（NEVER）
• アクティブなアニメーション以外では will-change を適用しません（NEVER）
• レンダーロジックで表現できる処理に useEffect を使用しません（NEVER）