turtleneck は何をしますか?
アプリに適したルックを選び、規律を持って構築します。すべてのルックはプリセットです。共有のコアの上に変数オーバーライドを適用した1つのファイルです。デフォルトのプリセットkeynoteは、コアそのものです。他のすべてのプリセットは、あるカテゴリの5つの大手サイトをブレンドしたものであり、それらのうちの1つをコピーしたものではありません。
このスキルがアクティブな場合、矛盾が生じる箇所では、一般的な「AIデフォルトを避ける」スキル(frontend-designなど)をオーバーライドします。keynoteでは、システムフォント、文頭大文字のアイブロー、トーングラデーションの見出しが正しいものです。
このファイルの隣にあるファイル:
tokens.css: コアとkeynoteの値。すべての色はlight-dark(light, dark)です。color-schemeを:root、.a-dark、.a-light、またはdata-themeに設定すると、どちらの半分が選択されます。すべてのプリセットフックはその:rootにリストされています。共有コンポーネント(タイプスケール、ボタン、タイル、.a-grid、.a-rail、.a-stats、.a-reveal)もそこにあります。styles/<preset>.css: 変数オーバーライドと、プリセット固有の少数のルール。tokens.cssの後に読み込みます。styles/<preset>.md: プリセットごとに1ページ:使用するタイミング、トークンテーブル、ルール、コンポーネントの差分、フォント、避けるべきこと、チェックリスト。recipes-html.md: ページスケルトン、ナビゲーション、ヒーロー、タイル、ベントー、ギャラリー、比較、フッター(スマホではアコーディオン)、リビール、および共有プリセットパターン(反転バンド、検索ヒーロー、レール、スペックテーブル、プランカード、コードフレーム)。tailwind.md、swiftui.md: それらのスタック向けの同じトークン。test-widths.html?src=<url>[&h=800][&full=1]: ページを320/375/414で横に並べ、オーバーフローレポートを表示します。full=1は各フレームをドキュメントの高さまで拡大し、全画面のスマホスクリーンショットを撮ります。example.htmlおよび../../demos/(agent-skillsリポジトリ内): 完成したページ。
ステップ0: アプリタイプを検出する(必須、コードの前に)
- 既存のデザインシステムまたは明確なスタイルリクエストが優先されます。 プロジェクトトークン、コンポーネントライブラリのテーマ、ブランドガイド、または「ダークで赤くして」などのリクエストがある場合は、それを使用し、以下のコアルールのみを保持し、テーブルはスキップします。
- シグナルを読み取ります: リクエスト、README、依存関係(
package.json、pyproject.toml、Podfile、Package.swift、Gemfile、*.csproj)、ルート、既存のCSS、プロダクトカテゴリとオーディエンス。 - 1つのプリセットを選択します:
| カテゴリ | シグナル(リクエスト、プロダクト、依存関係、ルート) | プリセット |
|---|---|---|
| プレミアムハードウェア | 物理製品、消費者向けデバイス、ライフスタイルガジェット、ローンチページ、「クリーン」、「ミニマル」、「プレミアム」、SwiftUIマーケティング画面、明確なシグナルなし | keynote |
| ビジネスソフトウェア | オフィス/生産性、B2B、CRM/ERP、イントラネット、IT/コンプライアンス、ヘルスケア、依存関係 @fluentui/*、@microsoft/teams-js、office-addin-*、@azure/*、Blazor/.NET、ルート /admin、/settings、/reports | enterprise |
| ストリーミング | 動画、映画/TV、シリーズ、予告編、ライブイベント、VOD、依存関係 hls.js、video.js、shaka-player、@mux/*、react-player、ルート /watch、/browse、/title | cinema |
| 音楽&ソーシャル | 音楽/オーディオ、プレイリスト、クリエイター、ソーシャルフィード、デート、フィットネスクラス、若者向けサブスクリプション、依存関係 howler、tone、wavesurfer.js、expo-av、ルート /player、/playlist、/profile | vibe |
| ゲーミングハードウェア | GPU/PCパーツ、コンソール、周辺機器、eスポーツ、ベンチマーク、ドライバー、「FPS」、依存関係 three、@react-three/fiber + チャートライブラリ、ルート /specs、/compare、/drivers | power |
| デベロッパー&クラウド | API、SDK、CLI、ホスティング、デプロイ、データベース、オブザーバビリティ、決済API、「開発者向け」、依存関係 next、@radix-ui/*、stripe、prisma、drizzle、trpc、turbo、ルート /docs、/changelog、/pricing | devtool |
| AI | モデル、アシスタント、チャット、エージェント、「AI搭載」を製品とする、依存関係 openai、@anthropic-ai/sdk、ai、langchain、transformers、ルート /chat、/research、/models | lab |
| 旅行 | 宿泊、フライト、ライド、ホテル、予約、旅程、日付ピッカー、地図(leaflet、mapbox-gl)、ルート /search、/stays、/trips、/book | journey |
| 小売 | ショップ、ストア、カタログ、マーケットプレイス、カート、チェックアウト、セール、食料品、ファッション、依存関係 @shopify/*、@medusajs/*、@commercetools/*、snipcart、@stripe/stripe-js(製品カタログあり)、ルート /shop、/products、/p/、/cart、/checkout、/category | market |
| 金融 | 銀行、クレジットカード、決済、ウォレット、保険、貸付、貯蓄、投資、消費者向けアカウントダッシュボード、依存関係 plaid、react-plaid-link、@adyen/*、dinero.js、currency.js、ルート /accounts、/cards、/rates、/apply、/transfer(開発者に販売される決済APIは devtool) | vault |
| 自動車 | 車、オートバイ、eバイク、EV充電、モビリティ、ディーラー、試乗、コンフィギュレーター、航続距離とスペックページ、ルート /models、/configure、/inventory、/test-drive、/dealers | drive |
| ページタイプ | プリセット(タイブレーカー) |
|---|---|
| ドキュメントサイト、チェンジログ | devtool |
| 管理ダッシュボード | ビジネスユーザー向けは enterprise、開発者向けは devtool |
| ショップ | market、単一のプレミアム製品ページは keynote |
| ポートフォリオ | 製品/デザイン作品は keynote、映画/写真/モーションは cinema |
| モバイルアプリ画面 | ネイティブ感のあるユーティリティは keynote、コンシューマーメディアとソーシャルは vibe |
| ゲーム / ゲームスタジオ | 競技志向でハードウェア的なものは power、ストーリー主導で予告編中心は cinema |
| 別製品内のAI機能 | その製品のカテゴリ、AIが製品そのものである場合のみ lab |
| 別製品内の予約フロー | 検索と結果ページのみ journey |
ユーザーのスタイルワードは直接マッピングされます: 「Apple風 / プレミアム / クリーン」 = keynote; 「Microsoft / Fluent」 = enterprise; 「Netflix風」 = cinema; 「Spotify風 / TikTok風」 = vibe; 「ゲーミング / NVIDIA風」 = power; 「Stripe / Vercel / GitHubスタイル」 = devtool; 「OpenAI / Anthropic風」 = lab; 「Airbnb / Booking風」 = journey; 「Amazon / IKEA風」 = market; 「銀行 / PayPal風」 = vault; 「Tesla / BMW風」 = drive。
結果はカテゴリのブレンドであり、その企業のサイトではありません(「商標とアセット」を参照)。
- シグナルが弱い、または競合する場合:
keynote。 - 構築前に選択内容を1行で述べます。例:「スタイル: devtool (Next.js + Prisma、ルート /docs と /pricing、開発者向け販売)。」その後、
styles/<preset>.mdを完全に読みます(keynote の場合はstyles/keynote.md)。
プリセットが変更できるもの
tokens.css(:root)の変数と、それ自身の少数のルールのみを通じて:
- フォント(ディスプレイ、本文、モノ)とタイプスケール、ウェイト、トラッキング、行の高さ;
- アイブローとイントロのスタイル、本文サイズ(UIは14px未満、読み取りテキストは16px未満にしない);
- サーフェスとテキストの色、ライト/ダークのデフォルト、1つのアクセントカラーとその上のテキスト、リンクとフォーカスの色;
- 角丸、境界線、シャドウ、タイルの塗りつぶし、ボタンの高さ、パディング、ウェイト、大文字/小文字;
- ナビゲーションの高さ、塗りつぶしとブラー、コンテンツ幅、セクションとタイルの間隔;
- イージング、持続時間、リビールの距離、ホバーとプレスのフィードバック;
- イメージとコピーの傾向(そのmdファイル内)。
以下のすべての行は、すべてのプリセットに適用されます。
ワークフロー
- プロジェクトを尊重します。
tokens.css+styles/<preset>.cssを読み込むか、Tailwindテーマをマージするか、SwiftUIパレットを追加します。プリセットは、そのmdファイルで指定された無料フォントにリンクする場合があります。ページはフォールバックスタックでも適切に見える必要があります。スタイリングのためにnpm依存関係を追加しないでください。 - ページ計画を3行で書きます: ページが売るもの、背景付きのセクション順序、そして1つの「見せ場」(反転した章、大きな統計ベントー、デモ、動画、スティッキースクロール)。
- 最初にコピーを書きます: 短い見出し(プリセットが長さを設定)、1行のサブ見出し、イントロは最大2行。
- レシピからセクションごとに構築します。
- すべてのテスト幅で検証します(レスポンシブ)。プリセットに両方がある場合はライトとダークで: スクリーンショット、オーバーフローチェック、チェックリスト。完了を報告する前に修正します。
コアルール
タイポグラフィ
- UIには1ファミリー(実際のコード、キー、API値のみモノを追加)。ディスプレイのウェイトはプリセットから。
- サイズが大きくなるにつれてトラッキングは狭くなります。本文のトラッキングが-0.022emを超えてマイナスになることはありません。
- ディスプレイサイズは流動的
clamp(min, rem + vw, max)です。常に中央の項にremを混ぜます。 - 読み取り用本文は16-17px、高密度UI、メタ行、フッターでのみ14px。本文の行の高さは1.45-1.6。
- 見出しには
text-wrap: balanceを、長い単語は折り返します(overflow-wrap、hyphens)。 - 重要な数字は大きく、表形式の数字を使用します。そのラベルは小さくします。
カラー
- ブランドカラーが最優先。 ユーザーまたはプロジェクトからのブランドカラーがプリセットのアクセントを置き換えます。プリセットのアクセントはフォールバックにすぎません。プリセットはレイアウト、タイポグラフィ、角丸、密度、画像、モーションを決定します。
- アクセントのレシピ(ブランドカラーまたは任意のアクセント変更)、
:rootに一度設定:--a-blue: 塗りつぶし、つまり指定されたブランドカラー(古い名前を保持。「アクセント」を意味する)。--a-on-accent: インクまたは白。塗りつぶし上で4.5:1に達する方。--a-blue-hover: 一段階暗い(ダークデフォルトでは明るい)色で、ラベルが依然として基準を満たすもの。--a-accent-text:light-dark(a, b)、ブランド色相を明度方向にシフトし、各テーマの--a-bgと--a-bg-alt上で4.5:1に達するまで調整。リンク、アクセントアイブロー、フォーカスリング(>= 3:1)がこれを読み取ります。 インク色のプライマリボタンを持つプリセット(lab、journey)はインクを--a-button-*に保持します。ブランドは依然としてここに配置されます。
- 1つのアクセント、小さなスコープ: プライマリCTA、フォーカス、リンク、ロゴマーク、小さなバッジ、「おすすめ」マーカー。プリセットが特に許可しない限り、大きなサーフェスや本文テキストには使用しません。ステータスカラーはステータスのみ。
- ニュートラルなサーフェスは2〜4段階。分離はトーン、ヘアライン、または1つのソフトシャドウレベルで行います。プリセットの指示に従います。
- テキストは白地に純粋な黒ではありません。本文グレーはAAコントラストを持つ実際のグレーです。
- どこでもAA: テキストとボタンラベルの塗りつぶし上は4.5:1、大きなテキスト、アイコン、意味を持つ境界線は3:1。
- ダークモードは反転したパレットではなく、異なるパレットです。浮き上がったサーフェスは1トーン明るく、奥行きにシャドウは使用しません。
レイアウトとリズム
- コンテンツには上限があります: ワイドグリッド(
--a-content-wide)内のテキストカラム(--a-content)、流動的なガター。 - セクションはページカラーと代替カラーを交互に使用します。タイルはセクションとは反対の塗りつぶしを取ります。
- プリセットがそう指示する場合は、中央配置のヒーローとセクションオープナー、タイル内のテキストと長いコピーは左揃え。
- 1ページに1つの見せ場、最大1つの反転(ダークまたはライト)チャプター。ただし、プリセットがバンド上に構築されている場合は除く。
レスポンシブ(厳格なルール: すべての解像度、すべてのプリセット)
- 流動的なタイポグラフィとスペーシングをクランプトークンから。小さい値は375px、大きい値は1440px。
- 壊れる可能性のある固定幅や高さは禁止:
max-width+ ガター、min()、minmax(0, 1fr)、aspect-ratio、min-height。100vhは使用禁止(svh/dvhを使用)。テキストを含むFlex/グリッドの子要素はmin-width: 0を取得。 - グリッドはスペースで再フロー:
repeat(auto-fit, minmax(min(100%, 20rem), 1fr))、デバイスのブレークポイントではない。 - メディアのスケール:
max-width: 100%; height: auto、SVGはviewBoxを保持。 - ナビゲーション: 834px未満(または6つ以上のリンクが収まらなくなったらすぐに: コンテナクエリ)では、テキストリンクは全画面メニュー(ネイティブ
popover、JS不要)に移動します。ベースのリンクスタイルを上書きするルールで<li>を隠します(レシピ: グローバルナビ)。マーク、検索、1つのアクションは表示したままにします。テキストリンクがない場合(検索、アカウント、カートのみ): ハンバーガーメニューは不要。 - どの幅でも水平スクロールバーは禁止。意図的なスクローラーのみ(ギャラリー、レール、コード)が、自身のボックス内でオーバーフローします。
- タッチターゲット >= 44x44px: 小さなピル、スウォッチ、パドル、ナビリンクは不可視のヒットエリア(
.a-hit)を取得します。 - セーフエリア:
viewport-fit=cover、ガターと下部パディングはenv(safe-area-inset-*)を使用。 - 非常に大きな画面: タイポグラフィとコンテンツは上限で停止します。背景は全幅のまま。
- スマホ横画面: ヒーローはビューポートの高さを必要としてはいけません。スティッキーなものは3分の1以上を覆ってはいけません。
- 200%ズーム: 半分の幅のビューポートと同じになります。すべてが再フローし、何もクリップされません。
完了と言う前にテスト幅を確認(ブラウザペイン: 各幅に resize_window、スクリーンショット、さらに document.documentElement.scrollWidth === innerWidth と、ビューポートより広い要素のリスト):
| 幅 | 意味 |
|---|---|
| 320 | 小型スマホ、640の200%ズーム |
| 375 / 414 | 標準 / 大型スマホ |
| 768 / 1024 | タブレット縦 / 横、小型ノートパソコン |
| 1280 / 1440 | ノートパソコン / デスクトップ(リファレンス幅) |
| 1920 / 2560 | フルHD / QHD、ウルトラワイド |
| 812x375 | スマホ横画面 |
| 640 | 1280pxの200%ズーム |
幅ごとに報告: スクリーンショット撮影、オーバーフローあり/なし、修正内容。ヘッドレスChromeは500px未満のウィンドウをクランプします。スマホの幅はブラウザペインまたは test-widths.html?src=<page url>(同じhttpルート)でテストします。
ヘッドレスキャプチャ: <html> に `data-theme=