app-design-studio は何をしますか?
目標: 1つのアプリ名から、美しく、同時に使いやすい、すべての画面で一貫性があり、デザイナー、Compose/Flutter/React Nativeを構築するエージェント、またはCompose-to-Figmaブリッジにそのまま渡せるデザインレポジトリを生成します。
このスキルが存在する理由: 画像モデルは個々の画面は魅力的に描きますが、画面間でスタイルがずれたり、状態を忘れたり、ユーザビリティを静かに損なったりします(小さすぎるテキスト、低コントラスト、小さなタップターゲット)。
解決策: まずデザインシステムを固定し、それから生成し、スクリプトで測定できるものと、ルーブリックと人間の選択でしか判断できないもの(センス)をチェックします。
ターゲット = プロファイル(S0で最初に決定。ユーザーがwebsite/portal/dashboardと言った場合、黙ってデフォルトにしないこと)
| ターゲット | 向き/サイズ | 使用する資料(これらのみ使用) |
|---|---|---|
mobile (アプリ) | 9:19.5のポートレート画面、1サイズ | screen-taxonomy.md、design-bible-template.mdとprompt-templates/README.mdのモバイルブロック、dp/sp単位の下限値 |
web site種 (ウェブサイト、ランディング、ストア、ブログ) | ランドスケープデスクトップ16:10 (1440x900) ページ、および同じページの幅390pxの狭いレスポンシブレイアウト | web-design.md、prompt-templates/web.md、design-bible-template.mdのウェブブロック、px単位の下限値 |
web app種 (ポータル、ダッシュボード、管理画面、SaaS) | ランドスケープデスクトップを優先。次に狭いレイアウト。ユーザーが電話がメインデバイスだと言った場合のみ、"mobile_first": trueを設定し、狭いレイアウトをプライマリにする。 | site種と同じ |
both | 共有のバイブルとトークン、2つのプロファイル | 両方のセット。1つのプロンプト内で混在させない。 |
inventory.jsonに"platform": "mobile" | "web"を設定します。プロンプトは正確に1つのプロファイルの語彙で書かれます。
キーワード衛生(このセクションが存在する理由): 画像モデルは与えられた単語に従います。「portrait」、「phone」、「status bar」、「9:19.5」、「bottom navigation」、「thumb zone」、「Android/iOS」、または「app screen」と言うウェブサイトのプロンプトは、電話の画面として返ってきます。ウェブのプロンプトは「website page」、「landscape desktop 16:10, 1440 wide」、「header with links」、「sidebar」、「browser-less」を使用します。狭いレイアウトは「narrow responsive layout, 390px wide」と呼ばれ、決して「phone screen」ではありません。python scripts/prompt_lint.py <design-dir>は、prompts/内の別のプロファイルの単語を使用するプロンプトを失敗させます。バッチを送信する前に実行してください。
出力ルール(常に遵守)
- 画像はUI自体であり、端から端までです。デバイスフレーム、電話/ラップトップのモックアップ、ブラウザのクローム、余分な背景、周囲のキャンバスはありません。(ユーザーがボードを要求した場合のみ、プレゼンテーションフレームを追加します。)モバイル:ポートレート画面。ウェブ:ランドスケープデスクトップページ、およびリストされている場合は狭いレイアウト。長いページは、1つの縦長の画像、または同じ幅の2〜3のセクション画像として。
- このスキル内の例はパターンの説明であり、コンテンツではありません。名前、コピー、パレット、タイプ、レイアウトをプロンプトにコピーしないでください(
references/design-craft.mdのバイアスガード)。 - 高忠実度:実際のコピー、実際のアイコン、実際の画像。Lorem Ipsumやプレースホルダーのブランド名は使用しません。
- セット全体で1つのデザインシステム。画面ごとに新しいスタイルを発明しないでください。
- 2つのプロンプトモード(
references/design-craft.md):簡潔(短い意図+重要な事実+雰囲気。最初のレンダリングとS2の方向性のデフォルトで、最も特徴的な結果が得られます)と固定(正確な文字列、カウント、バイブルブロック。選択後の兄弟や修正用)。最初は簡潔にレンダリングし、確認してから、同意が必要なものを固定します。モデルは美しさよりもはるかに一貫性で失敗しますが、最初のレンダリングを過度に制約すると機械的になります。 - 編集、再ロールしない:間違った文字列を1つ、その変更のみを指定して編集パスで修正します。完全な再ロールは、すでに承認されたすべてを破棄します。
- 実際のブランド、ロゴ、実在の人物の顔は使用しません。架空の名前と一般的なマークのみ。APIキーをリポジトリに書き込まないでください。
- ユーザーが書いた言語でユーザーに返信します(多くの場合Roman Urdu/Hinglish)。ファイルとプロンプトは英語のままです。
ワークフロー(S0-S9)
ユーザーのプロジェクトフォルダ内のdesign/<app-slug>/で作業します(レイアウト:references/repo-layout.md)。フェーズのステータスはdesign/<app-slug>/STATUS.mdで追跡します。結果を変更する場合にのみユーザーに質問します(S0で最大3質問)。それ以外の場合は、賢明なデフォルトを選択して、その旨を伝えます。
S0 イントーク。 アプリ/サイト名、1行の目的、対象ユーザー、ターゲット+種類(上の表。ユーザーが「website」、「portal」、「dashboard」、または「landing」という言葉を使い、ターゲットが不明確な場合は質問)、プラットフォームの雰囲気(モバイルのデフォルト:Android + iOSニュートラル、Material 3寄り。ウェブ:ニュートラル)、トーンワード、ライト/ダーク(デフォルト:ライト+ダークトークン、画面はライト)。BRIEF.mdを書きます(問題、対象ユーザー、スコープ、非目標)。ユーザーが利用できない場合は、待つ代わりに上部にあなたが解釈した内容を記載します。references/aesthetic-vs-usability.mdを一度読んでください。
S1 スクリーンインベントリ。 references/screen-taxonomy.md(ウェブ:references/web-design.mdセクション4)からinventory.jsonを構築します。固定コア(スプラッシュ、言語、オンボーディング、権限、認証、ホーム、設定)+ このアプリ固有の機能画面 + 詳細 + 状態 + ダイアログ + シート + コンポーネント。各アイテムには、ID、グループ、目的、状態、優先度があります。コンパクトなリストをユーザーに表示し、画像クレジットを使う前に確認を取ります。
S2 デザインプラン + バイブル + 3方向(人間によるゲート)。 まず、方向ごとに10行のデザインプランを書き(references/design-craft.mdセクション2)、汎用デフォルトに対して自己レビューします。次に、3つの短い代替案(異なるムード、パレットロジック、タイプ、シェイプランゲージ)としてバイブルを書きます(references/design-bible-template.md)。各バイブルは、すべての塗りつぶし色(on-primary、on-accent、バッジテキスト)上のテキスト色と、プラットフォームのステータスバー(Android:時刻左、アイコン右。iOS:9:41スタイル)を指定します。レンダリングする前に、各方向のパレットを小さなトークンファイルに配置し、scripts/contrast_check.pyを実行します。コントラストが不合格になる方向は、人間による選択に進んではいけません。各プロンプトを最初にprompts/<id>.<direction>.mdに書き、そのファイルのテキストを正確に送信します(保存されたプロンプトが再現可能なものです)。方向ごとに1つのヒーロー画面(ウェブ:同じページ、デスクトップとモバイル)をレンダリングします。3つすべてを1回のCodex呼び出しでバッチ処理します。止めてユーザーに選んでもらいます - センスはスクリプトでは判断できない唯一のものであり、ここで人間が決定します。選択をDESIGN.mdに記録します。
S3 トークン。 選択された方向からtokens.jsonを書きます(色 ライト/ダーク、タイプスケール、スペーシング 4/8グリッド、半径、エレベーション、アイコンサイズ、タッチターゲット)。scripts/contrast_check.py tokens.jsonを実行し、今のうちに不合格のペアを修正します(後で40画面を修正するより安上がりです)。
S4 コンポーネントボード。 トークンからコンポーネントシート(ボタン、入力、チップ、カード、リスト行、ナビゲーション、トップバー、トースト、ダイアログ、シート)を生成します。この画像は後続のすべての生成に渡される視覚的なリファレンスとなり、画面の一貫性を保ちます。
S5 スクリーン。 references/prompt-templates/を使用して、インベントリの順序でスクリーンを生成します。すべてのプロンプトは、固定されたバイブルブロック、正確な文字列とカウント、そして明示的な「追加しない」リストで始まります。ジョブに応じてエンジンを選択します。テキスト対応モデル(gpt-image/Codex、Nano Banana、Stitch)は画面全体に、HTMLレンダリングルート(正確なテキストとカウント、その後スクリーンショット。21画面のPDFリーダーセットでエンドツーエンドテスト済み:tokens.jsonのCSS変数とIconifyアイコンからhtml/<group>/<id>.htmlを書き、node scripts/render_screens.mjs <design-dir>でPNGと実際のDOMから測定された<id>.spec.jsonを書き込み、run_gates.pyで監査。Node + playwrightが必要。ローカルにインストールされていない場合は環境変数PLAYWRIGHT_MODULE/CHROME_PATHを設定)- FLUX/RunwareはUIテキストとカウントを誤るため、画面内に配置されるアートにのみ使用します。アイコンスタイルを1つのファミリーに保つために、アイコンにはIconify MCPを使用します。ツールがサポートする場合、スタイルリファレンスとしてコンポーネントボードを渡します。screens/<group>/<id>.pngと<id>.spec.json(要素、サイズ、フォントサイズ、色、インタラクティブフラグを含む - スキーマはreferences/repo-layout.md)として保存します。
S6 状態、ダイアログ、シート。 同じプロンプト、同じバイブル。空の状態は次のアクションをガイドします。エラーは視覚的に空とは異なります。ローディングは実際のレイアウトに一致するスケルトンを使用します。
S7 自己批評、評価、プロンプトログ。 ユーザーに見せる前に、すべてのレンダリングを自分で批評します(references/critique-template.md:エビデンス付きのユーザビリティ合格/不合格 + 美学ルーブリック。reports/critique/<id>.mdに書き込みます)。4.0未満またはユーザビリティFAILは、ユーザーを待たずに編集パスで修正するか、拒否して再生成することを意味します。すべての生成画像を確認した後、評価(accept / fix / reject)を書き込み、ログに記録します:python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...。拒否された画像はrejected/に移動します。prompt_log.py summaryは、プロンプトモードごとの受理率と繰り返し発生する失敗タグを表示します。2回拒否されたタグは、references/design-craft.mdの「学んだ教訓」セクションに追加されます(これがスキルの改善方法です)。次にpython scripts/run_gates.py design/<app-slug>を実行します。コントラスト、トークンリント、要素監査(タッチターゲット、最小テキストサイズ)、状態カバレッジを実行し、reports/gates.mdを書き込みます。次に、references/aesthetic-vs-usability.mdのルーブリックで各画面を採点します(PNGを開いて確認します。記憶から採点しないでください)。不合格の画面を再生成します。各画面につき最大2回試行します。それでも不合格の場合は、ループせずにユーザーにフラグを立てます。
S8 エクスポート。 リポジトリをアセンブルします(references/repo-layout.md):PNG、スペック、トークン、DESIGN.md、インベントリ、フローマップ、copy/strings.json、レポート。ユーザーが希望する場合のみのオプション追加:(a) 正確なCSS値のためのHTML真実レイヤー(references/image-qa-loop.md)、(b) ストアアセット - アイコン、フィーチャーグラフィック、HTMLテキストとしてレンダリングされた見出し付きのストアスクリーンショット。references/store-asset-specs.mdに対してscripts/validate_assets.pyで検証されます。マーケティング用ストアスクリーンショット(トップチャートアプリのような見出し主導のセット)には、これらの画面を入力としてstore-screenshotsスキルを使用します。オプションの引き継ぎ:トークン/スペックはComposeコード+ Figmaブリッジに供給されます。HANDOFF.mdにその旨を記載します。
S9 人間によるレビュー。 コンタクトシートとゲートレポートを提示します。実際のアプリが存在する前に生成されたものはすべてconceptとラベル付けされます(コンセプトのストアグラフィックを実際のキャプチャとして提示しないでください)。
判断ガイド(美学 vs ユーザビリティ)
下限はターゲットに依存します。モバイル = 以下のdp/sp数値。ウェブ = references/web-design.mdセクション3のpx単位の下限(44pxヒットエリア、本文 >= 16px、65ch行、390で水平スクロールなし)。ユーザビリティを下限、美学を上限として扱います。下限の数値は測定可能であるため交渉不可です:タッチターゲット >= 48dp(44pt iOS)、本文テキスト >= 16sp、12sp未満は不可、コントラスト4.5:1(大きなテキストとアイコンは3:1)、画面ごとに1つのプライマリアクション、キーアクションは下部のサムゾーン、4/8スペーシンググリッド。下限を超えたら、個性を発揮します:特徴的なタイプの組み合わせ、制御されたアクセント、フローごとに1つの印象的なイラストまたは画像モーメント、ゆったりとしたスペーシング。競合する場合(例:淡いグレーのエレガントなラベル)、ユーザビリティが優先され、他の場所(ウェイト、スペーシング、サイズコントラスト)で優雅さを取り戻します。下限を下げることはしません。
避けるべきこと(「AI特有の表現」)
最初のプロンプトを書く前に、references/design-craft.md、references/interaction-and-density.md、references/ai-tells-avoid.mdを読んでください(ブリーフには密度ターゲットを記載:少ない言葉、ゆったりとしたスペース、1つのプライマリアクション)。短縮版:紫青のグラデーション、理由のないガラスカード、ボックスインボックスのネスト、偽のチャートスパム、12ウィジェットのホーム画面、ジェネリックなアイコンパックの混合、小さな装飾ラベル、Lorem Ipsum、小さな編集で複製された画面。
リファレンスマップ
references/screen-taxonomy.md- どの画面/状態/ダイアログ/シートが存在し、いつ使用するか(MOBILEターゲットのみ)。references/web-design.md- ウェブサイト/ウェブアプリターゲット:ビューポート、px下限、ページ分類、レイアウト、ウェブAI特有の表現。references/prompt-templates/web.md- ウェブのFORMAT/CONTENTブロックとページタイプごとのプロンプト。references/aesthetic-vs-usability.md- ダイヤル、下限、ルーブリック、再生成ルール。references/design-bible-template.md- すべてのプロンプトで繰り返されるブロック。references/prompt-templates/- 画面タイプごとのプロンプト。references/design-craft.md- 簡潔 vs 固定プロンプト、デザインプラン、汎用デフォルト、一箇所での大胆さ、コピールール、批評ループ。references/ai-tells-avoid.md- アンチパターン。references/repo-layout.md- フォルダレイアウトとJSONスキーマ。references/image-qa-loop.md- 画像ごとの検証/編集ループ、オプションのHTML真実レイヤー、strings.json。references/store-asset-specs.md- Play/App Storeのサイズとルール(提出前に公式ページを再確認すること)。references/interaction-and-density.md- 単語/密度予算、プログレッシブディスクロージャー、可視インタラクション状態、レビュー質問(すべてのブリーフと批評で使用)。references/critique-template.md- 画像ごとの自己批評と修正ループ。scripts/prompt_log.py- 評価ログ + 学びのサマリー(S7参照)。assets/-tokens.json、inventory.json、spec.json、DESIGN.mdのスケルトン例。scripts/- 決定論的ゲート(Python 3.10+、Pillow、pydanticが必要。ランタイムはscripts/run_gates.py参照)。