app-design-studio 是做什麼的?
目標:從一個應用程式的名稱開始,產出一個同時兼具美觀與可用性的設計素材庫,所有畫面風格一致,並可隨時交付給設計師、建構 Compose/Flutter/React Native 的代理工具,或作為匯入 Figma 的橋樑。
為什麼需要這項技能:影像模型能夠繪製吸引人的單一畫面,但畫面間的風格會逐漸偏移、忘記處理各種狀態,且會悄悄破壞可用性(文字太小、對比度不足、觸控目標過小)。本技能的解決方案:先鎖定設計系統,再基於它進行生成,最後透過腳本檢查可量化的項目,並使用評分表加上人工挑選來判斷無法量化的部分(例如美感)。
目標 = 設定檔(請在 S0 階段立即決定;當使用者提到網站/入口網站/儀表板時,切勿預設為行動裝置)
| 目標 | 方向 / 尺寸 | 請閱讀這些檔案(且僅限這些檔案的用詞) |
|---|---|---|
mobile(行動應用程式) | 9:19.5 的直立式螢幕,單一尺寸 | 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 設為 true,並以窄版版面為主要版面 | 與 site 相同 |
both(同時包含) | 共用一份設計聖經與 token,但有兩份設定檔 | 同時使用兩套檔案,但絕不混在同一個提示詞中 |
請在 inventory.json 中設定 `"platform": "mobile" | "web"`。每個提示詞都應使用完全符合其目標設定詞彙的單一檔案。 |
關鍵詞衛生(此段落存在的意義): 影像模型會忠實遵循它所接收到的詞彙。一個包含「直立」、「手機」、「狀態列」、「9:19.5」、「底部導航」、「拇指區塊」、「Android/iOS」或「應用程式畫面」等詞彙的網站提示詞,會生成出一張手機畫面的圖。網站的提示詞應該使用「網站頁面」、「橫向桌面 16:10,寬度 1440」、「含連結的頁首」、「側邊欄」、「無瀏覽器邊框」。窄版版面應稱為「窄版響應式版面,寬度 390px」,絕對不要稱之為「手機畫面」。執行 python scripts/prompt_lint.py <design-dir> 會檢查 prompts/ 目錄下的所有提示詞,若發現使用了其他設定檔的詞彙則會報錯;請在大量發送提示詞前執行此檢查。
輸出規則(始終遵守)
- 圖片本身就是 UI,必須從邊緣到邊緣:不要有裝置外框、手機或筆電的模型圖、瀏覽器邊框、多餘的背景或畫布。(僅在使用者要求看板時才加上簡報邊框。)行動裝置:直立式螢幕。網頁:橫向桌面頁面,以及清單中有列出的窄版版面;長頁面可採用一張縱向長圖,或 2-3 張相同寬度的區段圖片。
- 本技能中的範例僅為模式示範,並非內容素材:切勿將其名稱、文案、色票、字體或版面配置直接複製到你的提示詞中(這是一項在
references/design-craft.md中定義的偏見防護機制)。 - 高擬真度:使用真實的文案、真實的圖示、真實的圖像。禁止使用假字、預設的品牌名稱。
- 整套素材庫使用統一的設計系統。切勿為每個畫面發明新的風格。
- 兩種提示模式(定義於
references/design-craft.md):簡潔模式(簡短的意圖 + 少數關鍵事實 + 整體感覺;適用於初次渲染與 S2 階段的調整方向,能產出最具特色的結果)以及鎖定模式(精確的字串、數量、設計聖經區塊;用於篩選確定後的同系列畫面與修正)。先以簡潔模式進行第一次渲染並觀察結果,然後再鎖定那些需要一致的項目。模型在一致性上出錯的機率遠高於美感不足,但對第一次渲染施加過多限制會讓結果顯得死板。 - 編輯,而非重新渲染:要修正錯誤的字串時,應以只提及該項變更的編輯提示詞來進行;一次完整的重新渲染會丟棄所有已通過審核的內容。
- 禁止使用真實品牌、標誌或真實人物的臉部圖像;僅可使用虛構的名稱與通用商標。切勿將 API 金鑰寫入素材庫。
- 使用使用者書寫的語言回覆他們(通常是羅馬化的烏爾都語/印度斯坦語);但檔案與提示詞保持使用英文。
工作流程(S0-S9)
請在使用者的專案資料夾 design/<app-slug>/ 中工作(資料夾結構請參考 references/repo-layout.md)。在 design/<app-slug>/STATUS.md 中追蹤各階段的狀態。僅在答案會改變最終結果時才詢問使用者(S0 階段最多問 3 個問題);否則,選擇一個合理的預設值並告知使用者。
S0 需求蒐集。 應用程式/網站名稱、一句話描述其目的、目標受眾、目標 + 類型(請參考上方表格;若使用者提到了「網站」、「入口網站」、「儀表板」或「登陸頁」等詞彙,且目標不明確時,務必提問)、平台風格(行動裝置預設:Android + iOS 中立,偏向 Material 3;網頁:中立)、風格調性詞彙、淺色/深色模式(預設:提供淺色與深色兩種 token,但僅渲染淺色畫面)。撰寫 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 節),並根據通用預設值進行自我審查。接著將設計聖經(參考 references/design-bible-template.md)撰寫成三個簡短的替代方案(不同的氛圍、色票邏輯、字體、形狀語言)。每個方案都需指定文字在所有填色色塊上的顏色(例如強調色上的文字、徽章文字)以及平台的狀態列風格(Android:時間在左,圖示在右;iOS:9:41 風格)。在渲染之前,將每個方向的色票放入一個小的 token 檔案中,並執行 scripts/contrast_check.py 進行檢查:任何僅靠犧牲對比度才能看起來好看的方案,都不得進入人工挑選環節。將每個方向的提示詞先寫入 prompts/<id>.<direction>.md,然後發送該檔案的精確內容(儲存的提示詞必須是可重現的)。為每個方向渲染一個主要的代表性畫面(網頁:渲染同一個頁面的桌面版與行動版)。將三個方向的批次在 一次 Codex 呼叫中完成。在此處停下,讓使用者選擇——美感是腳本無法判斷的唯一事物,因此這是人類決定方向的時刻。將選擇結果記錄在 DESIGN.md 中。
S3 Token。 根據所選方向撰寫 tokens.json(淺色/深色模式的顏色、字體級別、基於 4/8 網格的間距、圓角半徑、陰影層級、圖示尺寸、觸控目標尺寸)。執行 scripts/contrast_check.py tokens.json,並立即修復失敗的配對——現在修復遠比等到 40 個畫面完成後再修復來得便宜。
S4 元件面板。 根據 token 生成元件表(按鈕、輸入框、標籤、卡片、列表行、導航元件、頂部欄、提示條、對話框、底部面板)。這張圖片將作為後續所有生成階段的視覺參考,這是保持畫面一致的關鍵。
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 文字與數量,因此僅在需要生成畫面內部的美術圖案時才使用它。使用 Iconify MCP 來獲取圖示,以確保圖示風格保持一致。在工具支援的情況下,將元件面板作為樣式參考傳遞。將產出儲存為 screens/<group>/<id>.png 及其對應的 <id>.spec.json(包含元素尺寸、字體大小、顏色、是否可互動等資訊,schema 請參考 references/repo-layout.md)。
S6 狀態、對話框、底部面板。 使用相同的提示詞與設計聖經。空白狀態應引導使用者進行下一步操作;錯誤狀態在視覺上必須與空白狀態有所區別;載入狀態應使用符合實際版面配置的骨架畫面。
S7 自我審查、結論與提示詞日誌。 在展示任何渲染結果給使用者之前,先自行審查(參考 references/critique-template.md:撰寫可用性通過/失敗的證據與美感評分,存入 reports/critique/<id>.md);若評分低於 4.0 或任何可用性項目評為 FAIL,則應透過編輯提示詞進行修正,或拒絕該結果並重新生成,無需等待使用者。在查看過每一張生成的圖片後,撰寫結論(接受 / 修正 / 拒絕)並記錄到日誌中:執行 python scripts/prompt_log.py add <design-dir> --id ... --image ... --prompt ... --mode brief|locked|edit --verdict ... --tags ... --reason ...;被拒絕的圖片移至 rejected/ 目錄。prompt_log.py summary 會顯示每種提示詞模式的接受率與反覆出現的失敗標籤;任何被拒絕超過兩次的標籤都會被寫入 references/design-craft.md 的「經驗教訓」章節(這是本技能自我改進的方式)。然後執行 python scripts/run_gates.py design/<app-slug>。它會執行對比度檢查、token 一致性檢查、元素審計(觸控目標、最小文字大小)以及狀態覆蓋率檢查,並將結果寫入 reports/gates.md。接著使用 references/aesthetic-vs-usability.md 中的評分表對每個畫面進行評分(請開啟 PNG 圖片實際查看——不要憑記憶評分)。重新生成未通過門檻的畫面,每個畫面最多嘗試 2 次;若仍失敗,則將其標記給使用者,而非繼續循環嘗試。
S8 匯出。 組合完整的素材庫(結構請參考 references/repo-layout.md):包含 PNG 圖片、規格、token、DESIGN.md、畫面清單、流程圖、copy/strings.json、報告。根據使用者的需求,可選擇性地加入:(a) HTML 驗證層以確保精確的 CSS 數值(參考 references/image-qa-loop.md),(b) 商店資產 - 圖示、功能圖、商店截圖(其標題需使用 HTML 文字渲染,並使用 scripts/validate_assets.py 根據 references/store-asset-specs.md 進行驗證)。對於市集的商店截圖(例如頂尖應用程式使用的標題式截圖組),請將這些畫面作為輸入,使用 store-screenshots 技能來產生。可選擇性的交接文件:token 與規格可提供給 Compose 程式碼 + Figma 橋樑工具;請在 HANDOFF.md 中說明。
S9 人工審查。 展示畫面總覽縮圖與門檻檢查報告。任何在實際應用程式尚未存在時所生成的內容都必須標記為 concept(切勿將概念性的商店圖形呈現為真實的截圖)。
判斷指南(美學 vs. 可用性)
下限值取決於目標:行動裝置 = 下方所列的 dp/sp 數值;網頁 = references/web-design.md 第 3 節中以 px 為單位的下限值(48dp 點擊區域、正文字體大於等於 16px、每行最多 65 個字元、在 390px 寬度下無水平滾動)。將可用性視為不可妥協的地板,將美學視為可追求的目標。這些下限數值是不可協商的,因為它們是可量化的:觸控目標大於等於 48dp(44pt iOS)、正文字體大於等於 16sp 且無任何文字小於 12sp、對比度 4.5:1(大字型與圖示可接受 3:1)、每個畫面一個主要行動、關鍵行動位於下方的拇指操作區、基於 4/8 網格的間距。在上述下限之上,盡情展現個性:使用具有特色的字體搭配、控管重點色、為每個主要流程提供一個令人印象深刻的插圖或圖片、並使用充足的留白。當兩者衝突時(例如一個優雅但顏色過淡的灰色標籤),可用性優先,並透過其他方式(字重、間距、尺寸對比)來恢復優雅感,而非降低可用性下限。
應避免事項(「AI 特徵」)
在撰寫第一個提示詞前,請先閱讀 references/design-craft.md、references/interaction-and-density.md 和 references/ai-tells-avoid.md(簡報中需指定密度目標:精簡的文字、充足的留白、一個主要行動)。簡而言之,應避免:紫藍色漸層、無理由的玻璃卡片、盒子層層嵌套、假圖表垃圾資訊、十二個小工具的首頁、混合風格的通用圖示組合、裝飾性小標籤、假字(Lorem Ipsum)、以及僅有微小編輯的複製畫面。
參考文件索引
references/screen-taxonomy.md- 定義有哪些畫面/狀態/對話框/底部面板及其用途(僅限行動裝置目標)。references/web-design.md- 網站/網頁應用程式目標:顯示區域、以 px 為單位的下限值、頁面分類、版面配置、網頁 AI 特徵。references/prompt-templates/web.md- 網頁的格式/內容區塊以及各頁面類型的提示詞。references/aesthetic-vs-usability.md- 調整旋鈕、下限值、評分表、重新生成規則。references/design-bible-template.md- 每個提示詞中都會重複使用的標準區塊。references/prompt-templates/- 各畫面類型的提示詞範本。references/design-craft.md- 簡潔模式與鎖定模式提示詞的區別、設計計畫、通用預設值、將重點放在單一特色、文案規則、審查循環。references/ai-tells-avoid.md- 應避免的反模式。references/repo-layout.md- 資料夾結構與 JSON schema。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 腳本),用於對比度、token、元素審計與狀態覆蓋率。