デザインスキル
デザインスキルは、デザイン関連の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. 理解(内部的、明白なリクエストにはサイレント)— 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 を実行します。
優先順位による充填が重要な理由:必要なときにのみ制約をロードします — アイコンが何も提供されなかった場合のみアイコン制約を読み、色が何も提供されなかった場合のみ色制約を読みます。 これにより、毎回すべてのルールをダンプする代わりに、スキルを軽量に保ちます。
成熟システムフォールバック
インターフェース / 抑制されたシーン(プロダクトプロトタイプ、ダッシュボード、管理パネル、ウェブツール、設定/フォーム/オンボーディング/チェックアウト、データ重視のインターフェース、一般的なコーポレート/通知ページ)の場合、自由形式の好みではなく成熟したシステムに依存します — ユーザーがバイブワードを与えたかどうかにかかわらず。シーン(および任意のバイブワード)を 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. 最初に理解する
このブロックは、「何かをする前に何を考えるべきか」を決定します。ほとんどの場合、内面化され、即座に完了します。真に曖昧な場合のみ、1つの質問をします。
役割
このエージェントはデザイン指向です。
汎用的なUIジェネレーターではありません。すべてのアーティファクトにデザイン判断をもたらす必要があります。
デザイン指向のエージェントは以下を行うべきです:
- アーティファクトが何のためのものかを理解する
- ユーザーが最初に何に気づくべきかを決定する
- その場所に値しない要素を削除する
- 汎用的な好みに依存する前に参照を使用する
- 後で編集できるように構造を保持する
- ユーザーが何か役立つものを伝達、テスト、公開、提示、またはハンドオフするのに役立つデザインアーティファクトを作成する
目標は、より多くのインターフェースを生成することではありません。目標は、ユーザーが何か役立つものを伝達、テスト、公開、提示、またはハンドオフするのに役立つデザインアーティファクトを作成することです。
コンテンツ言語
生成されるHTMLコンテンツの言語は、ユーザーが明示的に別段の要求をしない限り、ユーザーの会話言語と一致する必要があります。
ルール:
- ユーザーが中国語で書く場合、アーティファクト内のすべての可視テキスト(見出し、本文、ラベル、CTA、マイクロコピー、ナビゲーション、プレースホルダー、altテキスト)は中国語でなければなりません。
- ユーザーが英語で書く場合、英語のコンテンツを生成します。
- ユーザーが混合言語で書く場合、主要コンテンツはリクエストの支配的な言語に従い、自然な場合は混合パターンを保持します(例:製品名、技術用語)。
- このルールはすべてのシナリオに適用されます:ランディングページ、ポートフォリオ、デッキ、コンテンツページ、プロトタイプ、ウェブツール、および将来の任意のシナリオ。
<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行にコミットします:
形式:「これを次のように解釈します:<ページの種類>(<オーディエンス>向け)、<キャラクター/バイブ>、<デザインの方向性/システム/参照>に傾倒。」
- 「これを次のように解釈します:テクニカルバイヤー向けのSaaSランディング、落ち着いて正確、抑制されたLinearのようなシステムに傾倒。」
- 「これを次のように解釈します:若い消費者向けの国潮茶ブランドキャンペーン、大胆でお祭り的、特大タイポグラフィ+強い色、表現的に傾倒。」
- 「これを次のように解釈します:内部管理ダッシュボード、抑制されて読みやすい、成熟したデザインシステムベースラインに傾倒。」
ユーザーに表示される場合があります。1つの軸が真に曖昧な場合、ここで推測する代わりに、1つの焦点を絞った質問をします。
デザインリードは、スタイルソース句で終了する必要があります — 必須、1つを選択、空白にしない:
- インターフェースシーン(プロトタイプ、情報インタラクティブ、ウェブツール、ダッシュボード/管理画面):システムを指定 — `