Communitygithub.com

wei18/apple-dev-skills

用於 AI 代理驅動的 Swift / Apple 平台開發的可重複使用 Claude Code 技能 — 可透過 git 子模組組合;彙集其他專業技能倉庫。

apple-dev-skills 是什麼?

此技能集合專為 AI 代理(如 Claude Code、Cursor、Codex)設計,用於 Apple 平台(iOS、macOS 等)的開發工作流程。它透過 git 子模組提供可組合的技能,並彙總其他專業技能倉庫,涵蓋從設計模型生成到程式碼審查等任務。核心技能之一是「iOS Design Mockup Generator」,它能根據書面規格(PRD、需求或用戶故事)生成一個自包含的 HTML 文件,模擬類似 Figma 的設計畫布,包含 iPhone 裝置框架、導航箭頭和設計標記面板。這解決了 iOS 工程師在編碼前向 PM 或利害關係人溝通 UI 概念的常見問題,無需製作完整原型或依賴 Figma 帳戶。該集合遵循 Apple 人機介面指南,確保視覺風格貼近原生 iOS,並支援迭代修改,以節省 AI 代理和開發者的時間。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add wei18/apple-dev-skills

在你喜歡的 AI 中提問

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

說明文件

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 有三個區域:

  1. 標題列(頂部):應用程式名稱、版本(若規格中未提供則為佔位符)、產生日期,以及箭頭類型的圖例(實心 = 推入,虛線 = 模態呈現,雙箭頭 = 標籤切換)。
  2. 畫面區域(主要,可水平滾動):所有 iPhone 框架按流程順序排列。將相關流程進行視覺分組(每個流程垂直欄,流程內水平進展)。每個框架下方:標籤如 S01 — Welcome。
  3. 設計標記面板(右側或底部,取決於畫布寬度):顏色、排版、間距、圓角半徑、陰影、元件。

箭頭以 一個絕對定位的 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。根據需要閱讀其他兩個檔案。

相關技能