dickwu/apple-design-skill

Apple Design Skill – AI驅動的Apple風格UI審查工具

是什麼 – 針對Claude Code、Cursor、Codex、OpenCode、Windsurf等AI程式助手的外掛程式（稱為 skill）。此技能讓助手能扮演設計審查員，依據Apple的Human Interface Guidelines（HIG）檢視UI。支援多種前端框架（Flutter、React Native、Tauri、Electron、SwiftUI、UIKit、AppKit），並能以所選框架的語言提出具體修復建議。

如何運作 – 倉儲包含：

• 122個由官方Apple HIG頁面生成的Markdown檔案（原始文字、標題、表格與變更日誌皆完整保留）。
• 一個小型Node腳本（scripts/pull-hig.mjs），可重新下載最新的HIG頁面並重新產生這些Markdown檔案。
• 一個SKILL.md，定義代理的「立場」、審查清單、報告格式，以及可選的improvement mode（提出設計權杖系統，如調色板、排版、動效等）。
• 路由表（references/hig-lookup.md），將請求（例如 「審查我的Flutter首頁」）對應到相關的HIG頁面。

當代理收到設計審查提示時，該技能會載入相應的HIG Markdown檔案，然後：

1. 檢查Apple的八項設計原則（目的、主體性、責任感、熟悉度、彈性、簡潔性、工藝、愉悅感）。
2. 驗證可存取性數值（文字縮放、對比度、控制項大小、VoiceOver、鍵盤、動效設定）。
3. 確認平台特定慣例（標籤欄、選單、安全區域、捷徑等）。
4. 審查視覺工藝（顏色、字型、佈局、圖示、動效、「視角」）。
5. 檢查互動模式（載入、警告、復原、破壞性操作）。
6. 檢查內容與文案（標籤、大小寫、錯誤訊息）。

每個發現均以 問題、原因（引用確切的HIG標題）和 修復方案（以開發者所用框架的語言撰寫）回傳。專用子模式涵蓋應用程式圖示、深色模式、「Liquid Glass」效果、引導流程、權限、表單、生成式AI元件和單一UI元件。

安裝 – 此技能透過通用的 skills CLI 分發：

npx skills add dickwu/apple-design-skill          # 為所有支援的代理安裝
npx skills add dickwu/apple-design-skill -a claude-code   # 僅限Claude Code
npx skills add dickwu/apple-design-skill -g               # 使用者級安裝

對於讀取本地 .claude/skills/、.cursorrules、.windsurfrules 等檔案的代理，也可直接將倉儲克隆至相應資料夾中。

典型用法 – 在與助手的對話中，只需提出例如：

• 「根據Apple指南審查我的Flutter應用首頁。」
• 「審計這個Tauri應用的可存取性。」
• 「這個macOS設定視窗是否符合平台慣例？」
• 「在不破壞iOS模式的前提下，為這個UI賦予一個視角。」 助手將回傳結構化審查報告與具體的程式碼級建議。

保持資料最新 – 執行內建腳本：

node scripts/pull-hig.mjs   # 需要Node 18+

該腳本會向 developer.apple.com 發出約150次請求，重寫 references/hig/*.md 檔案，並更新查找表。該腳本是決定性的；第二次執行應無變更。

授權與來源 – 指南文字源自Apple公開的Human Interface Guidelines，並在每個生成檔案中註明來源。此倉儲與Apple無關聯。程式碼與技能依倉儲授權「按原樣」提供（詳見倉儲中的LICENSE檔案）。

---

總結 – Apple Design Skill將通用LLM程式助手轉變為專門的UI設計審計工具，可在多個開發框架中強制執行Apple的設計標準，提供最新參考資料與可執行的、框架特定的修復方案。