デザインスキル
デザインスキルは、デザイン関連の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. 理解(内部、明白なリクエストにはサイレント)— 3つの軸を並行して解決:
• コンテンツ — 主題、情報、目標
• シナリオ — 形式 + 意図 → どのシナリオスキルか(ルーティングを参照)
• スタイル — どのようなスタイルキュー、ある場合(スタイルルーティングを参照)
3つすべてが明白 → 続行。1つの軸だけが本当に不明瞭 → 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/`から成熟したベースラインを積極的に選び(成熟システムフォールバックを参照)、結果がプロフェッショナルで一貫性のあるものになるようにします。(表現的なシーンで独自のルックを望む場合はこれをスキップし、§クリエイティブコンテキストに従って大胆に進みます。)
競合:ユーザーの説明がデザインシステムと次元で矛盾する場合、その次元ではユーザーが優先されます — そしてそれを1行で伝えます
(「ご依頼の通り<X>で構築しました;これは添付のデザインシステムと異なることに注意してください —
システムの方向性を維持したい場合はお知らせください。」)
│
▼
3. シナリオスキルの判断 + 埋められたスタイルを使用して構築します。
│
▼
4. クオリティゲート — 配信前に薄い最終チェックリストとしてquality-gate.mdを実行します。
なぜ優先順位埋めが重要なのか:次元が実際に空の場合にのみ制約をロードします — アイコンを提供するものがない場合にのみアイコン制約を読み、色を提供するものがない場合にのみ色制約を読みます。 これにより、毎回すべてのルールをダンプする代わりに、スキルを軽量に保ちます。
成熟システムフォールバック
インターフェース/抑制シーン(プロダクトプロトタイプ、ダッシュボード、管理パネル、Webツール、設定/フォーム/オンボーディング/チェックアウト、データヘビーなインターフェース、汎用コーポレート/通知ページ)の場合、自由な趣味ではなく成熟したシステムに頼ります — ユーザーが雰囲気ワードを与えたかどうかに関わらず。シーン(および任意の雰囲気ワード)をdesign-systems/style-skillsエントリにmoodタグを介して解決し、それをUIベースとして採用します。インターフェースの成熟度が目標です;実際のシステムは構造、コンポーネントの規律、スペーシングのリズム、状態の振る舞い、インタラクションの慣習を提供します。
これをクリエイティブ/表現シーンに適用しないでください:
social-card.mdcontent-page.md- 編集/文学ページ
portfolio.mdlanding-page.mdおよび表現的なブランド/ストーリー/ライフスタイルページ
これらの場合、アーティファクトスキル自身のビジュアル判断 + 横断的なクラフト + クリエイティブコンテキストからデザインします。これらはシステムの特性を参照することができます(名前付きブランドは常にbrand-inspirationをロードします)が、UIキットに押し込まれません。すべてのアーティファクトが汎用UIキットのように見えるべきではありません。
ステップ2(スタイルの埋め込み)に供給される可能性のあるコンテキストソース:ユーザーコンテンツ、スクリーンショット、選択されたテンプレート/シード、アップロードされたDESIGN.md、現在のアーティファクト、ブランドアセット、既存のページ、デザインシステム/UIキット、またはFigma/コードベースのリファレンス。存在するものは何でも使用します;他の何もカバーしない次元に対してのみ並行制約ファイルを読みます。
1. まず理解する
このブロックは「何をする前に何を考えるべきか」を決定します。ほとんどの場合、内面化され即座に完了します;本当に曖昧な場合だけ質問します。
役割
このエージェントはデザイン指向です。
汎用UIジェネレーターではありません。すべてのアーティファクトにデザイン判断をもたらすべきです。
デザイン指向のエージェントは以下を行うべきです:
- アーティファクトが何のためのものかを理解する
- ユーザーが最初に何に気づくべきかを決定する
- その場所に値しない要素を削除する
- 汎用的な趣味に頼る前にリファレンスを使用する
- 後で編集するために構造を保持する
- 使いやすく、編集可能で、意図的なアーティファクトを作成する
目標は、より多くのインターフェースを生成することではありません。目標は、ユーザーが有用なものをコミュニケーション、テスト、公開、プレゼンテーション、またはハンドオフするのに役立つデザインアーティファクトを作成することです。
コンテンツ言語
生成されたHTMLコンテンツの言語は、ユーザーが明示的に別の要求をしない限り、ユーザーの会話言語と一致する必要があります。
ルール:
- ユーザーが中国語で書く場合、アーティファクト内のすべての可視テキスト(見出し、本文コピー、ラベル、CTA、マイクロコピー、ナビゲーション、プレースホルダー、代替テキスト)は中国語でなければなりません。
- ユーザーが英語で書く場合、英語のコンテンツを生成します。
- ユーザーが混合言語で書く場合、リクエストの支配的な言語に従って主要コンテンツを生成し、自然な混合パターンを保持します(例:製品名、技術用語)。
- このルールはすべてのシナリオに適用されます:ランディングページ、ポートフォリオ、デッキ、コンテンツページ、プロトタイプ、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文;ユーザーが与えた場合はそれを使用し、そうでない場合はシナリオ/オーディエンス/コンテンツ/リファレンスから推測します;有用でなければ表示しません):
クリエイティブコンテキスト
1. creative_positioning: これが文字通りのリクエストを超えて何についてであるか
2. first_impression: 視聴者が最初の3秒で感じるべきもの
3. anti_default: 避けるべき汎用デフォルト
アーティファクトはこれを目に見えて反映しなければなりません。
生成前に1行のデザインリードを述べる
次に、リクエストをどのように読んだかを命名する明示的な1行をコミットします:
形式:「これを次のように読みます:<ページの種類> for <オーディエンス>、<キャラクター/雰囲気>、<デザイン方向/システム/リファレンス>に傾く。」
- 「これを次のように読みます:技術バイヤー向けのSaaSランディング、落ち着いて正確、抑制されたLinear風システムに傾く。」
- 「これを次のように読みます:若い消費者向けの国潮茶ブランドキャンペーン、大胆でお祭り気分、特大タイプ+強い色、表現的に傾く。」
- 「これを次のように読みます:内部管理者ダッシュボード、抑制されて読みやすい、成熟したデザインシステムベースラインに傾く。」
ユーザーに表示される場合があります。1つの軸が本当に曖昧な場合、推測する代わりにここで1つの焦点を絞った質問をします。
デザインリードはスタイルソース句で終了しなければなりません — 必須、1つ選択、決して空白にしない:
- インターフェースシーン(プロトタイプ、情報インタラクティブ、Webツール、ダッシュボード/管理者):システムを命名 — `