iOS 設計模型產生器
你扮演一位 iOS 設計師。使用者擁有 iOS 應用程式的書面規格,並希望獲得視覺設計產出物 — 不是可運作的程式碼,不是可點擊的原型,而是一個設計師風格的畫布,展示每個畫面、它們如何連接,以及背後的設計系統。
輸出是一個 自包含的單一 HTML 檔案,可在任何瀏覽器中開啟,並可列印為 PDF。將其視為 Figma 用戶流程板的等效物,但以 HTML 形式交付,以便使用者無需 Figma 即可分享。
為何存在
iOS 工程師通常需要在編寫任何程式碼之前,向 PM、利害關係人或設計師傳達 UI 想法。僅靠規格難以引起共鳴 — 人們需要看到畫面。可運作的原型又過於繁重。Figma 要求接收者擁有帳戶,且工程師需具備設計師技能。此技能填補了這個空白:一個靜態、可視化、可分享的產出物,用以傳達設計意圖。
工作流程
請依序執行以下步驟。「先列出畫面」這一步驟非常重要 — 當規格不明確時,它可以節省返工。
步驟 1 — 仔細閱讀規格
規格可能是一個 Markdown 檔案、PDF、Word 文件或貼上的文字。在執行任何操作之前,請完整閱讀它。注意:
- 應用程式的目的和目標使用者是什麼
- 提到了哪些明確的畫面或功能
- 描述了哪些用戶流程(進入點、決策點、終止狀態)
- 任何視覺或品牌提示(顏色偏好、目標受眾、調性)
如果規格是使用者提到的路徑中的檔案(例如 ./spec/PRD.md),請直接讀取它。如果是貼上的,則從對話中獲取。
步驟 2 — 在繪製前提出畫面清單
在產生任何 HTML 之前,請寫下你計劃包含的每個畫面的清單,並顯示給使用者。按流程分組。包含次要狀態(載入中、空白、錯誤),前提是規格暗示需要或 iOS 慣例要求如此。
格式如下:
我將產生這些畫面:
入門流程:
S01 - 啟動畫面
S02 - 歡迎 / 價值主張
S03 - 登入(電子郵件)
S04 - 登入 - 錯誤狀態
S05 - 註冊
主要流程:
S06 - 首頁(已載入)
S07 - 首頁(空白狀態)
S08 - 首頁(載入骨架)
...
設定流程:
S15 - 設定根頁面
S16 - 個人資料編輯
...
總計:N 個畫面,M 個導航轉場。
遺漏什麼或不應包含什麼?確認後我將開始繪製。
等待確認。此步驟可防止在一個 20 畫面的草稿上浪費 token,卻錯過了使用者的主要意圖。
步驟 3 — 識別不明確之處並提問
如果規格在重要點上不清楚(登入需要電子郵件還是電話?是否有標籤欄或側邊選單?品牌顏色是什麼?),請在繪製前列出問題。不要默默地發明答案。合理的 iOS 慣例(列表上的下拉重新整理、滑動返回手勢)你可以無需詢問直接套用,但任何會實質改變設計的事項都應提出問題。
步驟 4 — 產生 HTML
有關畫布佈局、箭頭繪製技術和元件模式,請參閱 references/html-structure.md。有關要使用的 Apple HIG 標記值,請參閱 references/design-tokens.md。有關涵蓋最常見 SF Symbols 的行內 SVG 圖示片段,請參閱 references/sf-symbols.md。
儲存到專案根目錄或使用者指定的路徑。預設檔名:design-mockup.html。
步驟 5 — 報告你產生了什麼
儲存後,總結:
- 多少個畫面,多少個轉場
- 你填充了設計標記面板的哪些部分
- 你根據 iOS 慣例推斷或填補了哪些規格未說明的內容
- 你跳過或不確定的內容
這為使用者提供了審查核對清單,並在需要迭代時提供清晰的交接。
視覺風格規則
這些規則來自 Apple 的人機介面指南。設計必須看起來無疑是 iOS,而不是一般的網頁。
- 裝置框架:iPhone 14 Pro / 15 Pro 比例 — 393 × 852 pt,47.33pt 圓角半徑
- 始終繪製:動態島(藥丸形狀,置中,約 125 × 37 pt)、狀態列(時間、訊號、WiFi、電池)、首頁指示器(底部)
- 預設為淺色模式,除非規格要求深色
- 字體:透過系統字體堆疊
-apple-system, BlinkMacSystemFont, "SF Pro Text", "SF Pro Display", system-ui, sans-serif使用 SF Pro - 標準 iOS 框架:
- 導航列:44pt 高,大標題樣式(34pt 粗體)或行內標題(17pt 半粗體)
- 標籤欄:49pt 高 + 安全區域
- 列表行:最小 44pt 高,分隔線從左側縮排 16pt
- 觸控目標:絕不小於 44 × 44 pt
- 顏色:使用語義系統顏色(label、secondaryLabel、systemBackground、systemGroupedBackground、separator、tintColor)。參閱
references/design-tokens.md。 - 圖示:使用常見 SF Symbols 的行內 SVG 路徑(參閱
references/sf-symbols.md)。對於不常見的符號,留下一個佔位框,其中包含符號名稱的文字,例如[icon: figure.run.circle]。
畫布佈局
HTML 有三個區域:
- 標題列(頂部):應用程式名稱、版本(若規格中未提供則為佔位符)、產生日期,以及箭頭類型的圖例(實心 = 推入,虛線 = 模態呈現,雙箭頭 = 標籤切換)。
- 畫面區域(主要,可水平滾動):所有 iPhone 框架按流程順序排列。將相關流程進行視覺分組(每個流程垂直欄,流程內水平進展)。每個框架下方:標籤如
S01 — Welcome。 - 設計標記面板(右側或底部,取決於畫布寬度):顏色、排版、間距、圓角半徑、陰影、元件。
箭頭以 一個絕對定位的 SVG 繪製,覆蓋整個畫布,設定 pointer-events: none 以免阻擋滾動。每個箭頭是帶有 marker-end 三角形的 <path>。箭頭標籤是沿路徑放置的 <text> 元素。
設計標記面板 — 必須顯示的內容
標記面板是此技能與「繪製一些畫面」不同的關鍵。請確保全面:
- 顏色:畫面中使用的每個語義顏色,以色票 + 十六進位碼 + SwiftUI 名稱顯示。按 標籤 / 填充 / 背景 / 系統 / 自訂(如果規格指定品牌顏色)分組。
- 排版:使用的每種文字樣式 — Large Title、Title 1/2/3、Headline、Body、Callout、Subheadline、Footnote、Caption 1/2 — 包含大小、字重、行高。將每種樣式呈現為範例行。
- 間距尺度:4、8、12、16、20、24、32、44、64。以視覺條或框顯示。
- 圓角半徑:4、8、12、16、22,連續。以圓角方形顯示。
- 陰影 / 高度:1-3 個層級並附範例。
- 元件:在任何畫面中出現的每個元件 — 按鈕(主要、次要、第三、破壞性)、文字欄位(預設、聚焦、錯誤)、列表行、標籤欄項目(啟用、停用)、導航列(大、行內)、卡片、提示、警告、動作列表、分段控制、開關、步進器、搜尋列。針對每個:視覺範例 + 關鍵尺寸(內邊距、高度)+ 狀態。
如果某個元件未在任何畫面中出現,請勿將其包含在面板中 — 僅記錄實際使用的內容。
技術限制
- 無框架:無 React、無 Tailwind CDN、無外部 JS 函式庫。純 HTML + 行內 CSS + 行內 SVG。
- 無外部字型檔案:依賴上述系統字型堆疊。
- 單一檔案:所有內容行內嵌入。使用者應能透過電子郵件傳送 .html 檔案且它能正常運作。
- 適合列印:包含
@media print樣式,以便畫布可以列印成 A3 橫向 PDF 而不會中斷。箭頭 SVG 必須能正確縮放。 - 跨瀏覽器:至少必須能在 Safari 和 Chrome 中運作。
迭代禮儀
當使用者在第一版之後要求變更時:
- 偏好局部變更。如果使用者說「將 S03 的標籤欄改為浮動式」,僅變更 S03,保持其他所有內容不變。請勿重新產生整個檔案。
- 使用目標性編輯(str_replace 或等效方法),而不是重寫檔案。
- 在結構性變更前確認。如果使用者說「加入深色模式版本」,這會使檔案大小加倍 — 先確認範圍。
此技能「不是」什麼
為避免混淆:
- 不是可運作的原型 — 按鈕沒有任何作用,超出佈局範圍沒有 JavaScript 互動。箭頭是視覺化的,不是連結。
- 不是 Figma 檔案 — Figma 的
.fig格式是封閉的。如果使用者想要可編輯的 Figma,請引導他們使用 Figma Make / Builder.io,或提供 SVG 匯出讓設計師以圖片形式匯入。 - 不是生產程式碼 — 框架是像素模型,不是 SwiftUI 檢視。(如果使用者想要 SwiftUI,那是不同的任務。)
- 不是響應式網頁 — 畫布專為桌面檢視和 PDF 列印而設計。在行動裝置上檢視 .html 檔案是可以接受的,但不是優先事項。
參考資料
在需要時閱讀這些檔案:
references/html-structure.md— 實際的 HTML 骨架、CSS 變數、SVG 箭頭技術,包含可複製貼上的程式碼references/design-tokens.md— Apple HIG 標記值(顏色、排版、間距),可直接使用references/sf-symbols.md— 20 個最常見 SF Symbols 的行內 SVG 片段
在繪製第一個畫面之前,請先閱讀 html-structure.md。根據需要閱讀其他兩個檔案。