Communitygithub.com

app-design-studio

將一個應用程式名稱或網站/網頁應用程式構想轉化為完整的、高擬真度的 UI 設計素材庫,包含所有頁面、狀態、對話框、組件等,並配備統一的設計系統與可量化的可用性門檻。

app-design-studio 是什麼?

此技能旨在解決單一影像生成工具在UI設計上常遇到的問題:產出單一畫面的美觀度尚可,但跨畫面一致性差、常遺漏各種狀態(如載入、空白、錯誤、離線),且容易違反可用性原則(例如文字過小、對比度不足、觸控目標過小)。它的運作方式是先鎖定一套設計系統(design bible),然後基於此系統生成所有畫面,最後透過腳本(對比度、token 一致性檢查)與人類審美判斷(使用評分表)進行雙重驗證。支援三種目標類型:行動應用程式(縱向螢幕)、網站(橫向桌面版面)與網頁應用程式(入口網站、儀表板)。工作流程為S0至S9的結構化階段,從初始需求蒐集、畫面清單建立、設計方向提案(需經人工篩選)、token 生成、元件面板製作,到完整畫面與狀態的產出、自我審查與門檻檢查,最後導出包含PNG、規格、token與報告的完整素材庫。支援兩種提示模式:「簡潔模式」(簡短意圖+關鍵事實,用於初版渲染,能產出最具特色的結果)與「鎖定模式」(精確的字串、數量、設計聖經區塊,用於後續修正與同系列畫面)。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zohaibmushwani/agent-skills/tree/HEAD/skills/app-design-studio

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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、元素審計與狀態覆蓋率。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

screenshot-to-compose

Turn app design screenshots (JPG/PNG, often AI-generated) or Figma frames into a native Kotlin Jetpack Compose UI that matches them, design-first. Measures pixels and colours (px to dp), writes screen/asset inventories and a design system with observed vs inferred values, builds Iconify icons into VectorDrawables, generates artwork instead of cropping the screenshots, implements MVI screens, then compares emulator or Roborazzi renders against the reference. Use whenever the user supplies screenshots, mockups or a design repository and wants them built as an Android Compose app, says "make this screen in Compose", "match the design", "px to dp", "screenshot to code", or wants a whole app UI built design-first, even if they never say "Compose".

store-screenshots

Create App Store and Google Play marketing screenshot sets that look like top-chart apps - a headline-led story of 5-8 frames with a poster-style first frame, zoomed real UI fragments, a dominant brand colour, panoramic links between frames, social proof and human touches - generated frame by frame with Codex (GPT Image) using the app's real screens as reference images, text-checked and edit-passed, then fitted to the exact store sizes. Use whenever the user wants store screenshots, "App Store screenshots", "Play Store images", listing graphics, a screenshot redesign or "before/after" for a store page, or wants their app's store page to convert better, even if they only say "screenshots" for an app. Takes real app screens (for example from app-design-studio) as input.

相關技能