bear-ui-skills

Bear UI スキル

AI エージェントで Bear 風のインターフェースを構築するための、独自の制約です。

適用する場合

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

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

色

• SHOULD 主なサーフェスには明るい背景を使用します
• MUST ページの背景（surface-base）に #FFFFFF を使用します
• SHOULD カラーパレットを絞ります（現在、16 色が検出されています）
• MUST アクセシビリティのため、テキストのコントラスト比を 4.5:1 以上に保ちます

セマンティックトークン

トークン	HEX	RGB	用途
surface-base	#FFFFFF	rgb(255,255,255)	ページの背景
surface-raised	#DDDDDE	rgb(221,221,222)	カード、モーダル、浮き上がったサーフェス
surface-overlay	#232428	rgb(35,36,40)	オーバーレイ、ツールチップ、ドロップダウン
text-primary	#8B8C90	rgb(139,140,144)	見出し、本文
text-secondary	#7D7D7F	rgb(125,125,127)	セカンダリテキスト、控えめなテキスト
text-tertiary	#AB8C8E	rgb(171,140,142)	補助テキスト
border-default	#EFEFEF	rgb(239,239,239)	控えめな境界線、区切り線

タイポグラフィ

• MUST 基本フォントファミリーに Inter を使用します
• SHOULD 一貫性を保つため、フォントファミリーは 1 つにします
• MUST 主見出しには 50px / 700 を使用します
• MUST 本文には 14px / 400 を使用します
• SHOULD フォントウェイトを絞ります（現在、5 種類が検出されています）
• MUST 見出しには text-balance を、本文には text-pretty を使用します
• SHOULD 数値データには tabular-nums を使用します
• NEVER 明示的に求められない限り、文字間隔を変更しません

テキストスタイル

スタイル	フォント	サイズ	ウェイト	色	数
heading-1	Inter	50px	700	#494949	1
text-23px	Inter	23px	semi_bold	#474747	1
text-23px	Inter	23px	500	#535353	1
text-22px	Inter	22px	400	#A6A6A6	1
text-20px	Inter	20px	400	#A7A7A7	1
text-17px	Inter	17px	400	#A4A4A4	1
text-17px	Inter	17px	400	#686868	1
text-16px	Inter	16px	400	#7D7D7D	1
text-16px	Inter	16px	300	#808080	1
text-16px	Inter	16px	400	#9B9B9B	1

タイポグラフィの参考情報

フォントファミリー：

• Inter（53 回使用）

フォントサイズ： 7px、10px、11px、12px、13px、14px、15px、16px、17px、20px、22px、23px、50px

余白

• MUST 余白には 4px グリッドを使用します
• SHOULD 次のスケールから余白を選びます：1px、2px、3px、4px、5px、6px、7px、8px
• SHOULD 要素間のデフォルトの間隔には 7px を使用します
• NEVER 任意の余白値を使用しません（デザインスケールを使用してください）
• SHOULD コンテナー内のパディングを一貫させます

境界線

• MUST 次のスケールから角丸を選びます：7px、11px、18px
• SHOULD 境界線の幅を 1px、2px、6px に制限します
• SHOULD デフォルトの角丸には 11px を使用します
• NEVER 任意の角丸値を使用しません（デザインスケールを使用してください）
• SHOULD 要素を区切るには、控えめな境界線（1px）を使用します

角丸の参考情報

スケール： 7px、11px、18px

レイアウト

• MUST 基準のビューポート幅を 1920px として設計します
• SHOULD 要素の幅には一貫した値を使用します：16px、178px、14px、177px、10px
• SHOULD 明確な階層を持つ、テキスト主体のレイアウトを維持します
• NEVER h-screen を使用せず、ビューポート全体の高さには h-dvh を使用します
• MUST 固定要素では safe-area-inset を考慮します
• SHOULD 正方形の要素には、w-* と h-* の組み合わせではなく size-* を使用します

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

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

コンポーネント

ボタン

バリエーション	背景	テキスト	境界線	高さ	角丸
ゴースト	transparent	#7D7D7F	なし	-	-

インタラクティブな状態

フォーカス

• MUST アクセントカラー（#5E6AD2）を使った 2px のアウトラインを使用します
• MUST 2px のアウトラインオフセットを使用します
• NEVER フォーカスインジケーターを削除しません

ホバー

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

無効状態

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

インタラクション

• 破壊的または取り消し不可能な操作には、必ず AlertDialog を使用します
• 読み込み状態には、構造的なスケルトンを使用することが望ましいです
• エラーは、操作が行われる場所の近くに必ず表示します
• input 要素または textarea 要素への貼り付けを決してブロックしません
• アイコンのみのボタンには、必ず aria-label を追加します

アニメーション

• 明示的に要求されない限り、アニメーションを追加しません
• 合成レイヤー上のプロパティ（transform、opacity）のみをアニメーションさせます
• レイアウトプロパティ（width、height、top、left、margin、padding）は決してアニメーションさせません
• 登場時のアニメーションには ease-out を使用することが望ましいです
• インタラクションのフィードバックは、必ず 200ms 以内にします
• prefers-reduced-motion を尊重することが望ましいです

パフォーマンス

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