Stitch DESIGN.md スキル は何をしますか?
あなたはデザインシステムリードのエキスパートです。提供された技術アセットを分析し、「セマンティックデザインシステム」を DESIGN.md というファイルにまとめることが目標です。
概要
このスキルは、Stitch で新しい画面を生成する際、既存のデザイン言語と完全に一致させるための「真実の源」となる DESIGN.md ファイルを作成するのに役立ちます。Stitch は、特定のカラー値でサポートされた「ビジュアルディスクリプション」を通じてデザインを解釈します。
前提条件
- Stitch MCP サーバーへのアクセス
- 少なくとも1つのデザイン済み画面がある Stitch プロジェクト
- Stitch 効果的なプロンプティングガイドへのアクセス: https://stitch.withgoogle.com/docs/learn/prompting/
目標
DESIGN.md ファイルは、Stitch に新しい画面を生成させる際、既存のデザイン言語と完全に一致させるための「真実の源」として機能します。Stitch は、特定のカラー値でサポートされた「ビジュアルディスクリプション」を通じてデザインを解釈します。
取得とネットワーキング
Stitch プロジェクトを分析するには、Stitch MCP サーバーツールを使用して画面メタデータとデザインアセットを取得する必要があります。
-
名前空間の検出:
list_toolsを実行して Stitch MCP プレフィックスを見つけます。以降のすべての呼び出しにはこのプレフィックス(例:mcp_stitch:)を使用します。 -
プロジェクトの検索(プロジェクト ID が提供されていない場合):
[prefix]:list_projectsをfilter: "view=owned"で呼び出し、すべてのユーザープロジェクトを取得します- タイトルまたは URL パターンで対象プロジェクトを特定します
nameフィールドからプロジェクト ID を抽出します(例:projects/13534454087919359824)
-
画面の検索(画面 ID が提供されていない場合):
[prefix]:list_screensをprojectId(フルパスではなく数値 ID のみ)で呼び出します- 画面タイトルを確認して対象画面を特定します(例: 「Home」、「Landing Page」)
- 画面の
nameフィールドから画面 ID を抽出します
-
メタデータの取得:
[prefix]:get_screenをprojectIdとscreenId(両方とも数値 ID のみ)で呼び出します- これにより、以下の情報を含む完全な画面オブジェクトが返されます:
screenshot.downloadUrl- デザインのビジュアルリファレンスhtmlCode.downloadUrl- 完全な HTML/CSS ソースコードwidth,height,deviceType- 画面寸法と対象プラットフォーム- カラーとスタイル情報を含む
designThemeを含むプロジェクトメタデータ
-
アセットのダウンロード:
web_fetchまたはread_url_contentを使用してhtmlCode.downloadUrlから HTML コードをダウンロードします- 必要に応じて
screenshot.downloadUrlからスクリーンショットをダウンロードします(ビジュアルリファレンス用) - HTML を解析して Tailwind クラス、カスタム CSS、コンポーネントパターンを抽出します
-
プロジェクトメタデータの抽出:
[prefix]:get_projectをプロジェクトのname(フルパス:projects/{id})で呼び出し、以下を取得します:- カラーモード、フォント、丸み、カスタムカラーを含む
designThemeオブジェクト - プロジェクトレベルのデザインガイドラインと説明
- デバイスタイプの設定とレイアウト原則
- カラーモード、フォント、丸み、カスタムカラーを含む
分析と合成の手順
1. プロジェクト ID の抽出 (JSON)
- プロジェクトタイトルを見つけます
- 特定のプロジェクト ID を見つけます(例: JSON の
nameフィールドから)
2. 雰囲気の定義(画像/HTML)
スクリーンショットと HTML 構造を評価し、全体的な「雰囲気」を把握します。ムードを説明するための示唆に富む形容詞を使用します(例: 「風通しの良い」、「密度の高い」、「ミニマリスト」、「実用的」)。
3. カラーパレットのマッピング (Tailwind Config/JSON)
システム内の主要な色を特定します。各色について、以下を提供します:
- その特性を伝える記述的な自然言語名(例: 「深みのあるミュートされたティールネイビー」)
- 正確性のための特定の16進数カラーコード(例: "#294056")
- その特定の機能的役割(例: 「プライマリアクションに使用」)
4. ジオメトリと形状の翻訳 (CSS/Tailwind)
テクニカルな border-radius とレイアウト値を物理的な記述に変換します:
rounded-fullを「ピル型」と記述rounded-lgを「微妙に丸みを帯びた角」と記述rounded-noneを「鋭い、角張ったエッジ」と記述
5. 深度とエレベーションの記述
UI がレイヤーをどのように扱うかを説明します。シャドウの存在と質を記述します(例: 「フラット」、「かすかなソフトな拡散シャドウ」、または「重くてコントラストの高いドロップシャドウ」)。
出力ガイドライン
- 言語: 記述的なデザイン用語と自然言語のみを使用します
- フォーマット: 以下の構造に従ってクリーンな Markdown ファイルを生成します
- 正確性: 色には記述的な名前を使用しながら、正確な16進数カラーコードを含めます
- 文脈: デザイン決定の「理由」を説明し、「何が」だけでなく説明します
出力フォーマット (DESIGN.md 構造)
# デザインシステム: [プロジェクトタイトル]
**プロジェクト ID:** [ここにプロジェクト ID を挿入]
## 1. ビジュアルテーマと雰囲気
(ムード、密度、美的哲学の説明。)
## 2. カラーパレットと役割
(色を記述名 + 16進数コード + 機能的役割でリストアップ。)
## 3. タイポグラフィルール
(フォントファミリー、見出しと本文の太さの使用法、文字間隔の特徴の説明。)
## 4. コンポーネントのスタイリング
* **ボタン:** (形状の説明、色の割り当て、動作)。
* **カード/コンテナ:** (角の丸みの説明、背景色、シャドウの深さ)。
* **入力/フォーム:** (ストロークスタイル、背景)。
## 5. レイアウト原則
(ホワイトスペース戦略、マージン、グリッド配置の説明。)
使用例
このスキルを Furniture Collection プロジェクトで使用するには:
-
プロジェクト情報を取得:
Stitch MCP サーバーを使用して Furniture Collection プロジェクトを取得 -
Home ページの画面詳細を取得:
Home ページ画面のコード、画像、画面オブジェクト情報を取得 -
ベストプラクティスを参照:
Stitch 効果的なプロンプティングガイドを参照: https://stitch.withgoogle.com/docs/learn/prompting/ -
分析して合成:
- 画面から関連するすべてのデザイントークンを抽出
- テクニカルな値を記述的な言語に翻訳
- DESIGN.md 構造に従って情報を整理
-
ファイルを生成:
- プロジェクトディレクトリに
DESIGN.mdを作成 - 指定されたフォーマットに正確に従う
- すべてのカラーコードが正確であることを確認
- 示唆に富むデザイナーフレンドリーな言語を使用
- プロジェクトディレクトリに
ベストプラクティス
- 記述的に: 「blue」や「rounded」のような一般的な用語を避け、「Ocean-deep Cerulean (#0077B6)」または「Gently curved edges」を使用
- 機能的に: 各デザイン要素が何に使用されるかを常に説明
- 一貫的に: ドキュメント全体で同じ用語を使用
- 視覚的に: 説明を通じて読者がデザインを視覚化できるようにする
- 正確に: 自然言語での記述の後に、正確な値(16進数コード、ピクセル値)を括弧内に含める
成功のためのヒント
- 全体像から始める: 詳細に入る前に全体的な美しさを理解する
- パターンを探す: 一貫したスペーシング、サイジング、スタイリングパターンを特定する
- 意味的に考える: 色を外見だけでなく、目的に基づいて命名する
- 階層を考慮する: ビジュアルウェイトと重要度がどのように伝達されるかを文書化する
- ガイドを参照する: Stitch 効果的なプロンプティングガイドの言語とパターンを使用する
避けるべき一般的な落とし穴
- ❌ テクニカルな専門用語を翻訳せずに使用する(例: 「rounded-xl」を「generously rounded corners」とせずにそのまま使う)
- ❌ カラーコードを省略したり、記述名のみを使用する
- ❌ デザイン要素の機能的役割を説明し忘れる
- ❌ 雰囲気の説明があいまいすぎる
- ❌ シャドウやスペーシングパターンなどの微妙なデザイン詳細を無視する