Craft UI は何をしますか?
リファレンス画像を取り込み、動作するレイアウトを出力する — ただし、プロダクトとリクエストを理解した後に限る。
このスキルが存在するのは、よくある失敗を防ぐためです。それは、ランダムなセクション、プレースホルダーコピー、デフォルトのグラデーション、空のバンドで構成された、一見もっともらしいページが生成されることです。これは、エージェントが証拠ではなくジャンルの習慣からデザインするときに発生します。ここでは、すべての構造的および視覚的な決定は、実際のプロダクト、ユーザーのブリーフ、または実際に見たリファレンスの3つのソースのいずれかに遡る必要があります。ソースが不足している場合は、収集するか、ユーザーに依頼してください。デフォルトで隙間を埋めてはいけません。
絶対的なルール
- 設計契約書(Design Contract)の前にコードを書かない(ステップ2)。「簡単な」ページであっても例外ではありません。
discovery: liteは契約書を短縮するものであり、削除するものではありません。エコノミーはルーターが処理し、コンテキストをスキップすることはありません。 - デフォルトよりもエビデンスを優先する。 すべてのトークン、セクション、コピー行は、その出典を明記します。「ランディングページでは典型的」はソースではありません。
- 構造は背骨であり、ビュッフェではない。 セクションは、訪問者の質問に答えるか、ブリーフの目標を達成する場合にのみ存在します。
references/anti-ai-slop.mdを参照してください。 - 実際のコンテンツ。 プロダクト名、ラベル、データ、言語はサイト/ブリーフから取得します。Lorem ipsum、偽のロゴ、でっち上げの指標、「Seu produto aqui」は、ユーザーがプレースホルダーを承認した場合を除き使用しません。
- ユーザーの言語で返信し、プロダクトの言語でUIを構築します(pt-BRのプロダクトにはpt-BRのコピーを使用)。
- 1つの印象的なモーションを、すべてのセクションにフェードアップ効果を適用するのではなく使用します。
- コンポーネントよりもトークンを優先する。 色、半径、タイポグラフィ、スペーシング、シャドウ、イージングはCSS変数に格納し、コンポーネントはそれらのみを参照します。
- エコノミーは決定である。 ルーターが冗長性と実行するスキルを設定します。該当するリファレンスセクションのみを読んでください。
- プロフェッショナルな品質基準。
references/quality-bar.mdが完了の定義です — コンテンツ、視覚的忠実度、レスポンシブ、WCAG AA、パフォーマンス、ハンドオフを含みます。terseモードでは静かにチェックしますが、決してスキップされません。
ワークフロー
0. トリアージ(メインエージェント、数秒)
- ユーザーのリクエストをそのままキャプチャします。URL、添付ファイル、「não quero」という制約、冗長性の手がかり(「só o código」、「rápido」、「me explica」)をメモします。
- 利用可能なものを確認します:サブエージェント/Taskツール、ブラウザまたはウェブフェッチ、ローカルリポジトリ、スキル/MCPリスト。
- リクエストが既存ファイルへの小さな微調整(1つの色、1つのスペーシング値)である場合、ルーターに伝えます —
discovery: liteを設定する可能性があります。新しいページやリデザインは常にdiscovery: fullを取得します。 - ユーザーが既存のレイアウトを「amador」、「precisa melhorar」、「conserta essa landing」と述べたり、コードのあるライブサイトを指したりした場合は、
references/polish-existing-site.mdを読み、そのパスに従います:実際のコードベースへの追加的な磨き上げであり、再構築ではありません。ファイルに触れる前にgit statusを実行します。
1. 3つのディスカバリーエージェント(並行して実行)
サブエージェントツール — OpenCode subagent、Claude Code Task/Agent、Codex spawn_agent、Cursorバックグラウンドエージェント — を使用します。サブエージェントツールがない場合は、メインエージェントで3つのパスを順次実行し、それぞれに見出しを付けてラベル付けします。ディスカバリーエージェントはコードを書きません。
| エージェント | ミッション | 契約書に提供するもの |
|---|---|---|
| A — プロダクションサイト分析 | プロダクションで公開されているサイトを理解する:プロダクト、オーディエンス、実際のコピー、現在の構造、ブランドトークン、制約。 | SITE CONTEXT BRIEF |
| B — リクエスト&リファレンス分析 | 実際のリクエストを解読し、実際に見たリファレンスからのみスタイルDNAを抽出する。リファレンスが提供されなかった場合は検索する。 | REQUEST BRIEF + STYLE DNA |
| C — スキルルーター/エコノミー | この実行に必要な最小限の追加スキル/ツールを選択し、冗長性を設定する。 | ROUTING DECISION |
完全な仕様、出力スキーマ、単語予算:references/agents.md。各エージェントに、スキルの絶対ルートパス、そのロール仕様、ユーザーの生のリクエスト、URL/添付ファイルを渡します。戻り値は単語予算内に収めます。
リファレンス画像が関係する場合は、references/pattern-transfer.md も読んでください。スタイルトークンは移動しますが、構成レシピは移動しません。リファレンスだけからヒーローやセクションパターンを採用してはいけません — プロダクト(A)とリクエスト(B)によって正当化される必要があります。
2. 設計契約書(Design Contract)— 厳格なゲート
references/design-contract.md を読みます。A + B + C を1つの契約書に統合します。次にチェックします:
- 構造の背骨が順序付けられており、各セクションに役割、ソース、リファレンスからそのままコピーされたトポロジー、実際のコンテンツがあり、空のバンドがない。
- すべてのトークンとコピー行にソースが明記されており、不明な点はマークされ、でっち上げられていない。
- エージェント/サイト/リファレンス間の競合は、推測ではなく、統合された1つの質問(最大3項目)をユーザーに問い合わせることで解決された。
- 冗長性とスキルリストはCからのものであり、「存在するから」という理由でスキルが実行されることはない。
- パターン採用台帳が存在する:すべての
adopt/adapt/dropはAとBを引用する。リファレンスだけからヒーロー/セクションレシピが来ていない(references/pattern-transfer.mdを参照)。 - 構成が、無関係な異なる分野のプロダクトに対してももっともらしくない。トークンは移植可能だが、ヒーローレシピは移植不可能である。
ディスカバリーサブエージェントは決してユーザーに質問せず、Gaps / Unknowns のみを報告します。メインエージェントは3つのブリーフすべてを収集し、統合された質問(最大3項目)を1回行い、回答が得られるまでゲートを閉じたままにします。重要な事実(プロダクト名、オーディエンス、実際のコンテンツ、リファレンス画像)がまだ不明な場合は、質問して停止します。ステップ3を開始しないでください。
3. 計画
コンパクトな計画:トークン、背骨のASCIIワイヤーフレーム、実際のコピー/データバンク、そして1つのモーションモーメントとそのトリガーおよび理由。リファレンスとサイトブリーフと比較します。デフォルトであり観察されたものではないものは、修正されるか削除されます。
4. 構築
- デフォルトでは、1つの自己完結型HTMLファイル(トークンとしてのCSS変数、実際のフォールバック付きGoogle Fonts)。ユーザーのプロジェクトがすでにReact/Tailwindを使用している場合にのみ、それを利用します。
- モーションレシピ:
references/motion-and-effects.md。固定のcdnjsバージョンからのGSAP。 - コードは最小限に保ちます:レイアウトに不要なライブラリや抽象化は追加しません。
- 1440 / 768 / 390 でレスポンシブ、可視フォーカス状態、
prefers-reduced-motionを尊重。 - 構築中に
references/anti-ai-slop.mdを再読します — 特に空のバンドとセクションビュッフェの行を確認します。
5. 視覚的に検証
レンダリングし、リファレンスおよびサイトブリーフと並べて比較します。利用可能な場合はブラウザツールを使用します(Cによってルーティングされます)。references/quality-bar.md の検証プロトコルを実行します:1440 / 768 / 390 での全ページスクリーンショット、セクションの順序とコンテンツの存在、空のバンドやクリップされたテキストがないこと、水平スクロールがないこと、実際のピクセルコントラスト、キーボードフォーカス、モーション削減、コンソールエラー。階層、スペーシングのリズム、半径/シャドウの一貫性、密度、言語をチェックします。修正ラウンド:冗長性が terse の場合は1回、full の場合は最大3回。最も大きな視覚的差異から修正し、チェックリストに合格したら停止します。
6. 返信
Cの冗長性に基づいてフォーマットします。terse:3〜5行 — 何が構築されたか、使用されたエビデンス、検証結果。full:さらに、どのリファレンス特性がどこから取得されたか、使用/スキップされたスキル、1つの提案された次の変更をリストします。references/quality-bar.md のハンドオフ基準に従い、既知の制限を1回述べ、常にユーザーの言語で記述します。
他のスキルの使用
エージェントCが実行ごとにこれを決定します。まずセッションで実際に利用可能なものを確認します。スキルがない場合はフォールバックを使用し、最後に1回言及します。
| フェーズ | Cが使用を指示した場合 | フォールバック |
|---|---|---|
| 計画/デザイン方向性 | Impeccable (/impeccable shape、次に craft);セッションごとに1回コンテキストステップを実行 | frontend-design、またはステップ3の計画 |
| レビューと磨き上げ | Impeccable critique、polish、audit | 契約書に対する自己レビュー |
| モーション品質 | emil-design-eng(イージング、持続時間、スプリング、ホバー/プレス用) | references/motion-and-effects.md |
| 視覚的検証 | Browser MCP(Chrome DevTools / Claude in Chrome / developer-mcp-chrome):3つの幅でスクリーンショット、コンソールを確認 | チェック内容を説明し、ユーザーにスクリーンショットを依頼 |
| 3Dロゴまたはオブジェクト | img2threejs(リファレンスに再構築する価値のある3Dオブジェクトが含まれている場合のみ;限界を明記:1つの画像では隠れた面を明らかにできない) | フラットSVGまたはCSS |
| コードを小さく保つ | ponytail(依存関係を追加する前に) | プレーンCSS + 1つのGSAPタイムライン |
該当するフェーズでのみスキルを呼び出します。静的なランディングページにimg2threejsは必要ありません。
オリジナリティと安全性
- パターンを再現し、アセットは再利用しないでください。リファレンスのロゴ、イラスト、ブランド名、正確なコピーを決して再利用してはいけません。ユーザーのブランドとA/Bからの実際のコンテンツを使用します。
- 多くのピンは商用UIキットにリンクしています。スタイルと構造のみを一致させます。
- リファレンスの外観は出発点です。ユーザビリティを損なう場合(低コントラスト、小さなタイプ)、ムードは維持し、問題を修正し、その旨を伝えます。
ファイル
references/agents.md— 3つのディスカバリーエージェント、スキーマ、予算。references/design-contract.md— 統合テンプレートと厳格なゲート。references/anti-ai-slop.md— 一般的で、積み重ねられた、空のレイアウトの症状と修正。references/quality-bar.md— プロフェッショナルな完了の定義と検証プロトコル。references/pattern-transfer.md— リファレンス画像が同じヒーローレシピを無関係なプロダクトに移植するのを防ぎます。references/polish-existing-site.md— 既存のプロダクションレイアウトを向上させるタスクのための追加的ワークフロー。references/categories.md— ジャンルのベースライン(最小限の実行可能性であり、セクションメニューではありません)。references/style-dna.md— リファレンス読み取りテンプレート;証拠が必要。references/motion-and-effects.md— CSSエフェクトとGSAPレシピ。assets/refs.json— 既知のリファレンスリンク(それでも表示が必要)。