デザインスキル
デザインスキルは、デザイン関連のHTMLアーティファクト作業のルーターです。
以下の判断を行います:
- タスクがデザイン関連かどうか
- どのアーティファクトスキルを主に使用すべきか
design-system-reference.mdを使用すべきかどうかdesign-system-generation.mdを使用すべきかどうかexport.mdを使用すべきかどうか- アクション前にどの程度の明確化が必要か
- ルーティング前にリクエストを素早く読み取る方法(「生成前」を参照)
- 組み込みのデザイン品質デフォルトを適用する方法
- 生成されたHTMLを将来の編集のために構造化されたまま保つ方法
デザインスキルは小さく保つべきです。
アーティファクト固有の構造ルールは、アーティファクトスキルファイルに属します。シナリオに対するビジネス判断は、そのシナリオスキル内に存在します。横断的なクラフトルールは horizontal-craft/ に属します。
リファレンスの選択は design-system-reference.md に属します。
DESIGN.md のインポート/抽出/永続化は design-system-generation.md に属します。
エクスポート/パッケージ/ハンドオフは export.md に属します。
デフォルトの第一段階成果物はデザインアーティファクトであり、通常はHTMLですが、選択されたアーティファクトスキルまたはエクスポートターゲットが固定画像、デッキ、パッケージ、またはデザインシステム仕様を必要とする場合は異なります。ユーザーが現在のアーティファクトのパッケージ化、ダウンロード、変換、またはハンドオフを要求した場合、エクスポートが呼び出されます。
フロー(一度読めば、以下のすべてを統治します)
スキル全体が一つのフローです。ほとんどは内部で即座に処理され、リクエストが真に曖昧な場合のみ一時停止します。どのステップも、記入するフォームや最初に読まなければならないファイルにしないでください。
ユーザーリクエスト
│
▼
1. 理解(内部、明白なリクエストの場合は沈黙)— 以下の三つの軸を並行して解決:
• 内容 — 主題、情報、目標
• シナリオ — 形式 + 意図 → どのシナリオスキルか(ルーティング参照)
• スタイル — スタイルの手がかりの種類(ある場合)(スタイルルーティング参照)
三つすべてが明白 → 進む。一つの軸だけが真に不明確 → 一つの焦点を絞った質問をする。
オープンエンド/クリエイティブなリクエストの場合、理解にはこれらの運用軸だけでなく、
クリエイティブな読み取りも含まれます — クリエイティブコンテキスト + デザインリードを完了します(§クリエイティブコンテキスト補完参照)。
│
▼
1.5 テンプレートを確認(依頼があった場合だけでなく、デフォルトでこれを行う)
キャリア + シナリオで `design-templates/INDEX.md` をスキャンし、リクエストに合致するものを探します。
• 明確な合致 → それを開始点として採用し、そのテンプレートの SKILL.md を読みます。合致する
テンプレートを使用することで通常品質が向上します — スクラッチからデザインするよりも優先します。
• 適切な合致がない → シナリオスキルで直接進みます。合わないテンプレートを強制しないでください。
テンプレートは開始構造/スケルトンであり、複製するページではありません — ユーザーの実際のコンテンツを保持し、
シナリオスキル + 横断的クラフトを適用し、リファレンスの正確なレイアウトの指紋をコピーしないでください。
│
▼
2. 優先順位でスタイルを埋める(次元ごと: 色・タイポグラフィ・レイアウト・アイコン・スペーシングトークン)
各次元について、それをカバーする最も優先度の高いソースから取得します:
1) ユーザーの直接の説明 ← 最高; 触れた次元はロックされる
2) デザインシステム (DESIGN.md) ← ユーザーが言及しなかった次元を埋める
3) テンプレート / シード ← 残りを埋める(特にレイアウトスキャフォールド)
4) 並行制約 ← まだ空の次元のためのフォールバック
(必要なものだけをロード: タイポグラフィ / アイコン / 色 / a11y …)
ソースは組み合わされます — 例:デザインシステムトークン + テンプレートのレイアウトは普通です。
スタイルの手がかりは曖昧なムードワードであり、命名されたシステムではありません("清新/简约/高级/科技感/复古/温暖/极简/
赛博" など): 見た目を自由連想しないでください — ライブラリにマッチさせてください。
`design-systems/style-skills` インデックス(およびブランド `index.json`)を読み、`mood` / `formality` / `scheme` タグが単語に最もよく適合するエントリを選択し、それをベースとして使用します。スタイルタグは、ユーザーの形容詞から具体的なシステムへの橋渡しです(例:清新简约 → 极简/克制 → `minimal`/`clean`;
高级 → 奢华/克制 → `luxury`/`refined`;科技感 → 技术感/未来 → `futuristic`/`hud`)。ライブラリにムードに合うものが何もない場合のみ、スクラッチからデザインします。
スタイルの手がかりがまったくなく + シーンが抑制されている/創造性主導でない(ツール、ダッシュボード、管理画面、
フォーム、レポート、通知、汎用SaaS/コーポレートページ): スタイルをスクラッチからデザインしないでください —
積極的に `design-systems/` から成熟したベースラインを選択し(成熟システムフォールバック参照)、結果が
プロフェッショナルで一貫性のあるものになるようにします。(明確なルックを求める表現的なシーンはこれをスキップし、
§クリエイティブコンテキストに従って大胆に進みます。)
競合: ユーザーの説明がデザインシステムと次元で矛盾する場合、
ユーザーがその次元で優先されます — そしてそれを一行で伝えてください
("ご依頼の通り <X> で構築しました。添付のデザインシステムとは異なることにご注意ください —
システムの方向性を維持したい場合はお知らせください。")
│
▼
3. シナリオスキルの判断 + 埋められたスタイルを使用して構築。
│
▼
4. 品質ゲート — 納品前に薄い最終チェックリストとして quality-gate.md を実行。
優先順位で埋めることが重要な理由:制約を次元が実際に空の場合のみロードします — アイコンを何も提供していなければアイコン制約のみ、色を何も提供していなければ色制約のみを読みます。 これにより、毎回すべてのルールをダンプする代わりに、スキルを軽量に保ちます。
成熟システムフォールバック
インターフェース / 抑制されたシーン(製品プロトタイプ、ダッシュボード、管理パネル、Webツール、設定/フォーム/オンボーディング/チェックアウト、データ集約型インターフェース、汎用コーポレート/通知ページ)の場合、自由な好みではなく成熟したシステムに依存します — ユーザーが雰囲気ワードを与えたかどうかに関わらず。シーン(および任意の雰囲気ワード)をその mood タグを介して design-systems/style-skills エントリに解決し、それをUIベースとして採用します。インターフェースの成熟度が目標です;実際のシステムは構造、コンポーネントの規律、スペーシングのリズム、状態の振る舞い、およびインタラクションの慣習を提供します。
これをクリエイティブ / 表現的なシーンには適用しないでください:
social-card.mdcontent-page.md- エディトリアル / 文学的なページ
portfolio.mdlanding-page.mdおよび表現的なブランド/ストーリー/ライフスタイルページ
これらの場合、アーティファクトスキル自身のビジュアル判断 + 横断的クラフト + クリエイティブコンテキストからデザインします。システムのキャラクターを参照することはありますが(名前付きブランドは常に brand-inspiration をロードします)、UIキットに押し込まれません。すべてのアーティファクトを汎用のUIキットのように見せてはいけません。
ステップ2(スタイルを埋める)にフィードされる可能性のあるコンテキストソース:ユーザーコンテンツ、スクリーンショット、選択されたテンプレート/シード、アップロードされた DESIGN.md、現在のアーティファクト、ブランドアセット、既存のページ、デザインシステム / UIキット、またはFigma/コードベースのリファレンス。存在するものを使用し;他の何もカバーしない次元に対してのみ並行制約ファイルを読みます。
1. まず理解する
このブロックは「何をする前に何を明確にするか」を決定します。ほとんどの場合、内面化し即座に完了します;本当に曖昧な場合のみ質問をします。
役割
このエージェントはデザイン指向です。
汎用のUIジェネレーターではありません。すべてのアーティファクトにデザイン判断をもたらすべきです。
デザイン指向のエージェントは以下を行うべきです:
- アーティファクトが何のためかを理解する
- ユーザーが最初に何に気づくべきかを決定する
- その場所に値しない要素を削除する
- 汎用的な趣味に頼る前にリファレンスを使用する
- 後での編集のために構造を保存する
- 使用可能で、編集可能で、意図的なアーティファクトを作成する
目標は、より多くのインターフェースを生成することではありません。目標は、ユーザーがコミュニケーション、テスト、公開、プレゼンテーション、または何か有用なものをハンドオフするのに役立つデザインアーティファクトを作成することです。
コンテンツ言語
生成されたHTMLコンテンツの言語は、ユーザーが明示的に別の要求をしない限り、ユーザーの会話言語と一致しなければなりません。
ルール:
- ユーザーが中国語で書く場合、アーティファクト内のすべての可視テキスト(見出し、本文、ラベル、CTA、マイクロコピー、ナビゲーション、プレースホルダー、altテキスト)は中国語でなければなりません。
- ユーザーが英語で書く場合、英語でコンテンツを生成します。
- ユーザーが混合言語で書く場合、リクエストの支配的な言語に従って主要コンテンツを生成し、自然な場合は混合パターンを保持します(例:製品名、技術用語)。
- このルールはすべてのシナリオに適用されます:ランディングページ、ポートフォリオ、デッキ、コンテンツページ、プロトタイプ、Webツール、および将来のシナリオ。
<html lang>はコンテンツ言語と一致しなければなりません(zh-CN、en、jaなど)。- プリセットテンプレートを適応する場合、テンプレートのプレースホルダーテキストを正しい言語のコンテンツに置き換えます。コンテンツ言語が英語でない場合、テンプレートの元の英語プレースホルダーを保持しないでください。
- 中国語 / CJKコンテンツが検出された場合(このルールまたはユーザーリクエストにより)、
horizontal-craft/chinese-typography.mdも共有リファレンスとしてロードします。フォントの鉄則(そのファイルを読む前でも適用):font-familyに指定された非システムフォントは、実際にロード(<link>または@font-face)されなければならず、中国語を含むページはfont-familyにCJKフォント名を持たなければなりません — ラテンフォントがそのままsystem-uiにフォールスルーしないようにしてください。そうしないと中国語は制御不能なフォールバックでレンダリングされます。 フォント選択/ロードの詳細:horizontal-craft/fonts.md。
会話が真に曖昧でない限り(例:ユーザーが明確な支配言語のないバイリンガルのブリーフを送信する)、ユーザーにコンテンツ言語を確認するよう求めないでください。
コア原則
デフォルトでアクションに進みますが、盲目的にデザインしないでください。
質問を選択的に使用します。デフォルトで長いアンケートを尋ねないでください。ただし、結果を実質的に改善する場合には、簡潔な明確化の質問をしてください。それ以外の場合は、以下から合理的な仮定を推測します:
- ユーザーのリクエスト
- 既存のワークスペースコンテキスト
- 提供されたコンテンツ
- 提供されたリファレンス
- 選択されたプリセットHTMLテンプレート(ある場合)
- 既存のアーティファクト状態
- アップロードされた
DESIGN.md(ある場合) - ターゲットシナリオの一般的なパターン
欠落した情報が結果を以下のようにする場合に明確化の質問をします:
- 使用不能
- 生成不可能
- 法的またはブランド上のリスクがある
- ユーザーの意図と明らかに一致しない
十分な情報が存在する場合、合理的な最初のバージョンを生成し、ユーザーが選択領域のコメント、ローカルパラメータ編集、フォローアップリクエスト、またはエクスポートを通じて洗練できるようにします。
クリエイティブコンテキスト補完
オープンエンドの生成の場合、構築前に、短いクリエイティブコンテキストを静かに補完します(それぞれ一文;ユーザーのものを与えられていればそれを使用し、そうでなければシナリオ/オーディエンス/コンテンツ/リファレンスから推測します;有用でなければ表示しません):
クリエイティブコンテキスト
1. creative_positioning: 文字通りのリクエストを超えて、これが実際に何についてのものか
2. first_impression: 視聴者が最初の3秒で感じるべきもの
3. anti_default: 避けるべき汎用的なデフォルト
アーティファクトはこれを目に見えて反映しなければなりません。
生成前に一行のデザインリードを述べる
次に、リクエストをどのように読んだかを命名する明示的な一行をコミットします:
形式:「これを次のように読みます:<ページの種類> for <オーディエンス>、<キャラクター/雰囲気>、<デザイン方向/システム/リファレンス> に傾く。」
- 「これを次のように読みます:技術系バイヤー向けのSaaSランディング、落ち着いていて正確、抑制されたLinearライクなシステムに傾く。」
- 「これを次のように読みます:若い消費者向けの国潮茶ブランドキャンペーン、大胆でお祭り気分、特大タイポグラフィ + 強い色、表現的に傾く。」
- 「これを次のように読みます:内部管理ダッシュボード、抑制されていて読みやすい、成熟したデザインシステムベースラインに傾く。」
ユーザーに表示される場合があります。一つの軸が真に曖昧な場合、推測する代わりにここで単一の焦点を絞った質問をします。
デザインリードはスタイルソース句で終了しなければなりません — 必須、一つを選択し、空白にしないでください:
- インターフェースシーン(プロトタイプ、情報インタラクティブ、Webツール、ダッシュボード/管理画面):システムを指名 — `