URLからのDESIGN.md
入力: URL。オプションの第2引数: 出力パス(デフォルトは./DESIGN.md)。
Playwright MCP(mcp__plugin_playwright_playwright__*)を使用します。最初に1回のToolSearch呼び出しでブラウザツールをロードしてください。
スクリプットの実行
extract.js、motion.js、stack.jsはこのファイルと同じディレクトリにあります。これらを実行するには: ファイルを読み込み、先頭のコメント行を削除し、残りのアロー関数をbrowser_evaluateのfunction引数として渡します。すべてJSONを返します。stack.jsは非同期(スクリプトをフェッチ)ですが、browser_evaluateはこれをサポートしています。
フロー
-
開く。
browser_navigateでURLに移動します。browser_resizeで1440x900にリサイズします。クッキーバナーがコンテンツを覆っている場合は、その同意/閉じるボタンをクリックします。キャプチャや「ブロックされました」ページが表示された場合は停止します。ユーザーに伝え、何も書き込まないでください。 -
導入アニメーションを待つ。 3秒待ち、スクリーンショットを撮ります。ヒーローが空白、ぼやけている、または半分フェードしているように見える場合は、まだ表示中です: さらに2秒待ってから再度撮影します。モーション&インタラクションのために、表示方法(ブラーイン、フェードアップ、スタッガー)を記録します。アニメーション途中の値は正しくないため、ヒーローが完全に表示されるまで何も実行しないでください。 トークン。
extract.jsを実行します。結果を保持します。 -
見る。 デスクトップ幅でスクリーンショットを撮ります:
- ページの上部
- 中央:
browser_evaluate() => scrollTo(0, document.body.scrollHeight / 2)、800ms待機 - 下部: 同様に
scrollHeightを使用、800ms待機
スクロールに応じて移動、フェード、表示されるものを記録します。
-
モーション。 スクロール後に
motion.jsを実行します。これにより、遅延読み込みの3Dキャンバスがすでに存在するようになります。 スタック。 まずページ全体をスクロールします(約900pxずつ、150ms間隔; 1画面サイトの場合はホイールイベントを使用)これにより遅延チャンクが読み込まれ、次にstack.jsを実行します。ページのグローバル、DOM、読み込まれたリソース、CSS、および読み込まれたすべてのスクリプト(インラインと遅延チャンク)のテキストをチェックし、以下を返します:stack: カテゴリ別のライブラリとエビデンス: フレームワーク/プラットフォーム (Next, Nuxt, Astro, SvelteKit, Gatsby, Remix, React, Vue, Angular, Svelte, Framer, Webflow, Wix, Squarespace, Shopify, WordPress, Lovable)、UIキット/アイコン (Tailwind, Radix/shadcn, Headless UI, MUI, Chakra, Mantine, Ant, Bootstrap, Sonner, Lucide, Font Awesome, Phosphor)、3D (Three.js, React Three Fiber, drei, postprocessing, OGL, Babylon, PlayCanvas, A-Frame, regl, twgl, curtains.js, Spline, model-viewer, COBE, Unicorn Studio, Vanta, 生のWebGL)、2D (PixiJS, p5, Paper, Konva, tsParticles, Rive, Lottie)、アニメーション (GSAP + Flip/Draggable/MorphSVG/DrawSVG/MotionPath/CustomEase, Framer Motion, anime.js, React Spring, Velocity, Popmotion, AutoAnimate, Theatre.js)、スクロール (ScrollTrigger, ScrollSmoother, Observer, Lenis, Locomotive, smooth-scrollbar, AOS, ScrollReveal, Rellax, CSSスクロール駆動)、テキスト (SplitText, SplitType, Splitting, Typed, ScrambleText)、スライダー (Swiper, Splide, Embla, Keen, Glide, Flickity, Slick)、ページ遷移 (Barba, Swup, Taxi, Highway, View Transitions)、オーディオ (Howler, Tone)、物理 (Matter, cannon-es, Rapier)。note: WebGLが汎用3Dエンジンなしで実行されている場合に設定されます。つまり、手書きのWebGLです。components: accordion, tabs, dialog, menu, tooltip, carousel, marquee, form, video, iframe, animated SVG, custom cursor, preloader, theme toggleの数。shaders(GLSLソース),scrollTriggers(trigger/start/end/scrub/pin),tweens(GSAP to/from with ease, duration, stagger),motionProps(Framer Motion initial/animate/whileInView),threeObjects(使用されたジオメトリ、マテリアル、ローダー、パス),assets(モデル、HDR、Rive、Spline、Lottie、ビデオ、オーディオ),scripts.failed。
使用方法:
- グローバル、DOM、リソースからのエビデンスを最も信頼します。フレームワークランタイムファイル(ReactやNextの内部など)内でのみ見つかった一致は慎重に扱い、スクリーンショットで表示されるものと照合して確認します。
- シェーダーを読み、平易な言葉で何をするか説明します(ベンド、フレア、フラッター、角丸SDF、ノイズ、パーティクル、グローブ)。エンジン、最大1〜2行の主要なGLSL行、およびスクロール配線を 3D & メディア と スクロール動作 に記載します。シェーダー全体をDESIGN.mdにコピーしないでください。
tweensとscrollTriggersを具体的なモーション仕様に変換します(例:「見出しが文字に分割され、blur(7px)から上昇、0.7秒、スタッガー0.017秒、power2.out、上部がビューポートの70%に達したとき」)。scripts.failedが多い場合、クロスオリジンスクリプトがfetchをブロックしています。既知のギャップにリストします。
-
ホバー状態。
browser_hoverでプライマリCTA、1つのカード、1つのナビリンクにホバーします。各ホバーの後、その要素(targetとして渡す)に対してbrowser_evaluateを実行します:(el) => { const s = getComputedStyle(el); return { bg: s.backgroundColor, color: s.color, border: s.borderColor, shadow: s.boxShadow, transform: s.transform, opacity: s.opacity }; }。extract.jsからの静止値と比較します。各差分が-hoverコンポーネントバリアントになります。 -
モバイル。
browser_resizeで390x844にリサイズし、上部にスクロールし、3秒待機(イントロアニメーションが再再生)、スクリーンショットを1枚撮ります。ナビゲーションがどのように折りたたまれ、タイプスケールとグリッドがどのように変化するかを記録します。 -
その他のページ。 メインナビゲーションから、最大3つの内部リンク(できれば価格、製品/機能、ドキュメント/ブログ)を選択します。各リンクに移動し、スクリーンショットを1枚撮り、
extract.jsを実行します。これらを使用して、追加のコンポーネント(価格カード、タブ、テーブル、FAQ、フォーム)を見つけます。 -
出力ファイルを書く 以下のテンプレートを使用します。
-
リント。
npx -y @google/design.md lint <path>を実行します。すべてのエラーを修正します。Responsive Behavior、Motion & Interaction、3D & Media、Iteration Guide、またはKnown Gapsに関する警告は予期されたものです(カスタムセクション)。孤立トークンに関する警告は問題ありません。npxが何も表示しない場合(WindowsのGit Bashで発生)、一時フォルダにインストールして直接実行します:npm i --no-save @google/design.md、その後node node_modules/@google/design.md/dist/index.js lint <path>。Nodeまたはネットワークがない場合は、一度だけその旨を伝え、この手順をスキップします。 -
終了。
browser_close。ユーザーにファイルパス、見つけた3〜5個の特徴的な特性、および既知のギャップを伝えます。
特殊なサイト
- 1画面サイト(
document.body.scrollHeightがビューポートの高さに等しい): スクロールはページが担当します。マウスを中央に移動し、scrollToの代わりにホイールイベント(page.mouse.wheel)を使用し、数回のホイール操作ごとにスクリーンショットを撮ります。 - キャンバスがページを覆っているためにホバーが失敗する: マウスの位置でホバーし、
CANVASをスキップしてdocument.elementsFromPoint(x, y)でカーソル下の要素を読み取ります。計算されたスタイルが変わらない場合、効果はWebGLまたはJSで描画されています。既知のギャップに記録します。 - 明るい背景上の白いUIテキスト:
mix-blend-mode: differenceを示します。getComputedStyle(el).mixBlendModeを確認し、画面上で見える色(255 − 背景色)とブレンドモードを記録します。 - プリローダー: 最初のスクリーンショットにロゴまたは名前のみが表示される場合、それをコンポーネントとして記録し、さらに長く(モバイル含めて8秒以上)待機します。
- オンボーディングモーダルまたはオブジェクトベースのナビゲーション(部屋、テレビ、デスクトップ): モーダルをコンポーネントとしてキャプチャし、それをステップ実行し、少なくとも1つの「部屋」を開いてサブテーマとして抽出します。
- テーマトグル:
page.emulateMedia({ colorScheme: 'dark' })でダークテーマを表示します。prefers-color-schemeまたは[data-theme]CSS変数を読み取ります。トグルボタンがタイムアウトする場合は、[aria-label="..."]で{ force: true }を指定してクリックするか、スタイルシートから直接[data-theme="light"]ルールを読み取ります。 - ボタンテキストの重複文字(「GGeett iinn」): 文字ごとのテキストロールホバー効果を示します。ホバー&フォーカス状態の下に記録します。
- テンプレートの残骸(例: 未使用のshadcn変数
--primary: 229 84% 39%): スクリーンショットで表示されないCSS変数は無視します。
browser_evaluate呼び出しがスローされた場合、2秒待ってから1回再試行します。再度失敗した場合、そのデータなしで続行し、既知のギャップに記録します。
記述ルール
- すべての16進数、サイズ、太さ、半径、影、期間、イージングは抽出されたデータから取得します。値を発明しないでください。値が欠落している場合は、それを省略し、既知のギャップにリストします。
- ほぼ重複する値はクリーンなスケールにまとめます。例: スペーシング
7px 8px 9pxは8pxになります。アクセントカラーでない限り、3回未満使用された色は無視します。 - カラートークンにはセマンティック名を使用します:
primary、on-primary、primary-hover、ink、ink-muted、ink-subtle、canvas、surface-1..n、hairline、semantic-success|warning|error。反転した明/暗セクションにはinverse-*を使用します。 - タイポグラフィトークン:
display-xl/lg/md、headline、subhead、body-lg、body、body-sm、caption、button、eyebrow、mono。ピクセルの行の高さを単位なしの比率に変換します(64px on 64pxは1.0になります)。 components:では、"{colors.primary}"や"{typography.button}"のようなトークン参照を使用します。各状態を独自のキーに配置します(button-primary、button-primary-hover)。許可されるプロパティ:backgroundColor、textColor、typography、rounded、padding、size、height、width。- 透明色(抽出出力の
#ffffff @0.08): コンポーネントのbackgroundColorについては、キャンバスカラーにアルファ×(色 − キャンバス)でチャンネルを追加し、不透明な16進数(channel = canvas + alpha × (color − canvas))に平坦化します。そうしないと、リンターのコントラストチェックが誤検出します。境界線は、8桁の16進数(#ffffff14)のままで透明でもかまいません。 - 散文では、トークンを
`{colors.primary}`(#5e6ad2)のように引用し、読者が名前と値の両方を確認できるようにします。 - ベースの概要、Do's and Don'ts、モーションの説明は、スクリーンショットで表示される内容に基づきます。具体的に記述し(「影の代わりにヘアライン境界線」)、一般的な表現(「クリーンでモダン」)は避けます。
- 3D: シーンが何か、どこにあるか、サイズ、エンジン(
librariesから)、およびどのように反応するか(スクロール、カーソル、アイドルループ)を説明します。モデルやシェーダーをダウンロードしようとしないでください。 - モーション値(期間、イージング、キーフレーム)は散文のみに記述します。仕様には
motion:トークングループはありません。
テンプレート
examples/linear.app-DESIGN.mdは、完成したリントクリーンな出力です。期待される詳細レベルを確認するために一度読んでください。
---
version: alpha
name: <サイト>-設計分析
description: "<1つの密な段落: キャンバスカラー、インク、単一アクセント、表示タイプとトラッキング、カード処理、特徴的なモチーフ。16進数値をインラインで含めます。>"
colors:
primary: "#..."
on-primary: "#..."
primary-hover: "#..."
ink: "#..."
ink-muted: "#..."
canvas: "#..."
surface-1: "#..."
hairline: "#..."
typography:
display-xl:
fontFamily: <フォント>
fontSize: 64px
fontWeight: 510
lineHeight: 1.0
letterSpacing: -1.4px
body:
fontFamily: <フォント>
fontSize: 16px
fontWeight: 400
lineHeight: 1.5
button:
fontFamily: <フォント>
fontSize: 14px
fontWeight: 510
lineHeight: 1.0
rounded:
sm: 4px
md: 8px
lg: 12px
pill: 9999px
spacing:
xxs: 4px
xs: 8px
sm: 12px
md: 16px
lg: 24px
xl: 32px
section: 96px
components:
button-primary:
backgroundColor: "{colors.primary}"
textColor: "{colors.on-primary}"
typography: "{typography.button}"
rounded: "{rounded.md}"
padding: 8px 14px
button-primary-hover:
backgroundColor: "{colors.primary-hover}"
feature-card:
backgroundColor: "{colors.surface-1}"
textColor: "{colors.ink}"
rounded: "{rounded.lg}"
padding: 24px
top-nav:
backgroundColor: "{colors.canvas}"
textColor: "{colors.ink}"
height: 64px
---
## 概要
<2〜4段落: ムード、密度、個性、ページリズム、何がそれを認識可能にするか。>
**主な特徴:**
- ...
## 色
> ソースページ: <訪問したページのリスト>
### ブランド & アクセント
- **<説明的な名前>** ({colors.primary}): <役割>
### サーフェス
### テキスト
### セマンティック
## タイポグラフィ
### フォントファミリー
### 階層
| トークン | サイズ | 太さ | 行の高さ | トラッキング | 使用法 |
|-------|------|--------|-------------|----------|-----|
### 原則
### フォント代替に関する注意
<フォントがプロプライエタリな場合のオープンソースの代替。>
## レイアウト
### スペーシングシステム
### グリッド & コンテナ
<最大幅、列数、ガター。>
### ホワイトスペースの哲学
## エレベーション & 奥行き
| レベル | 処理 | 使用法 |
|-------|-----------|-----|
<extract.jsからの影、またはそれらなしで階層を実現する方法(サーフェスラダー、ヘアライン)。>
### 装飾的な奥行き
## シェイプ
### 角丸スケール
### 写真 & イラストレーションのジオメトリ
## コンポーネント
### ボタン
**`button-primary`**: <トークン参照を使用した説明、およびそのホバー状態>
### カード & コンテナ
### 入力 & フォーム
### ナビゲーション
### フッター
### <その他のサイト固有コンポーネント>
## してはいけないこと
### する
- ...
### しない
- ...
## レスポンシブ動作
### ブレークポイント
| 名前 | 幅 | 主な変更点 |
|------|-------|-------------|
### タッチターゲット
### 折りたたみ戦略
### 画像の動作
## モーション & インタラクション
### タイミング & イージング
| 使用法 | プロパティ | 期間 | イージング |
|-----|----------|----------|--------|
<motion.jsのトランジションから、使用頻度順にランク付け。>
### ホバー & フォーカス状態
<ホバー差分から: 何がどのくらいの速さで変化するか。>
### スクロール動作
<スムーズスクロール、スナップ、スティッキー要素、スクリーンショットで見られたスクロールリビール、ライブラリ(Lenis、GSAP ScrollTrigger、AOS)。>
### 環境アニメーション
<ループするキーフレーム: 名前、アニメーション化するもの、期間。>
### モーション軽減
<サイトに`prefers-reduced-motion`ルールはありますか?推奨されるフォールバック。>
## 3D & メディア
<ない場合: 「3Dやビデオはありません。奥行きは<X>から得られます。」そうでない場合、シーンまたはビデオごとに1エントリ:>
- **<シーン名>**: <エンジン>, <位置とサイズ>, <表示内容>, <反応方法>。<エンジン/アプローチ>で再構築。静的フォールバック: <ポスター画像/グラデーション>。
## 技術スタック
| レイヤー | 使用 | エビデンス |
|-------|------|----------|
<stack.jsのカテゴリでヒットがあったものごとに1行: フレームワーク/プラットフォーム、UIキット、3D、2D、アニメーション、スクロール、テキスト、スライダー、ページ遷移、オーディオ。エビデンス = グローバル、DOMマーカー、またはファイル。>
**特徴的な効果の構築方法:**
- **<効果名>**: <ライブラリ+テクニックを1〜3文で、正確な設定値(イーズ、期間、スタッガー、スクラブ)と主要なシェーダーアイデアがあればそれも含めます。>
**再構築レシピ:** <外観を再現するための最小限のライブラリセット、例:「Next.js + Tailwind + GSAP (ScrollTrigger,
…
[翻訳のため切り詰め]