OneMore — Apple HIG 設計智慧
你的設計還需要另一件事。
OneMore 是一個配備專業代理的 Apple HIG 設計智慧系統。你只要說 /onemore,剩下的它會搞定。創意視野、實作、動畫、無障礙審查,以及影片動態分析——每一項都由載入精確規則的專屬專家處理。
運作方式
當使用者呼叫 /onemore 時,分類其意圖並自動派發正確的代理。使用者完全不需要知道是哪個代理在運作——他們只會得到 Apple 品質的結果。
流程狀態追蹤
重要:針對流程中的每一個步驟,使用 TaskCreate 在終端機中顯示視覺進度。每個任務必須設定 activeForm 來顯示 spinner 文字。
每個路由的任務模式
從頭建置(創意 → 建置 → 審查):
TaskCreate: "分類意圖" activeForm: "正在分類意圖"
TaskCreate: "執行創意總監" activeForm: "正在執行創意總監"
TaskCreate: "提交簡報供確認" activeForm: "正在準備創意簡報"
TaskCreate: "使用 Apple HIG 建置" activeForm: "正在依 Apple HIG 規則建置"
TaskCreate: "執行品質審查" activeForm: "正在執行品質審查"
修復 / 改善:
TaskCreate: "分析現有程式碼" activeForm: "正在分析現有程式碼"
TaskCreate: "套用 HIG 改善" activeForm: "正在套用 Apple HIG 改善"
動畫處理:
TaskCreate: "分析動態需求" activeForm: "正在分析動態需求"
TaskCreate: "實作動畫" activeForm: "正在實作彈簧動畫"
審查 / 稽核:
TaskCreate: "執行 HIG 品質檢查表" activeForm: "正在執行 39 項規則的 HIG 檢查表"
無障礙:
TaskCreate: "執行 WCAG 2.2 稽核" activeForm: "正在執行 WCAG 2.2 無障礙稽核"
影片參考:
TaskCreate: "分析參考影片" activeForm: "正在分析參考影片"
TaskCreate: "產生動態規格" activeForm: "正在產生動態規格"
TaskCreate: "依規格實作" activeForm: "正在依動態規格實作"
將每個任務標記為 in_progress 後再開始,並在完成後標記為 completed。這樣便能建立視覺流程:
⠋ 正在分類意圖...
✓ 分類意圖
⠋ 正在執行創意總監...
✓ 執行創意總監
⠋ 正在依 Apple HIG 規則建置...
意圖分類與路由
讀取使用者的訊息,並比對到其中一條路由:
路由 1:從頭建置
觸發詞: "build", "create", "design", "make me", "landing page", "new website", "new app", "new dashboard" 也會觸發: 模糊的提示如「SaaS 分析產品」且未提及現有程式碼
流程:onemore-vision → [使用者確認簡報] → onemore-build → onemore-review
步驟:
- 派發
onemore-vision代理——它會產生一份創意簡報 - 將簡報呈現給使用者,要求確認
- 確認後,將該簡報派發給
onemore-build代理 - 建置完成後,派發
onemore-review代理進行品質把關 - 若審查發現重大問題,修復後再交付
路由 2:修復 / 改善 / 更新
觸發詞: "fix", "improve", "update", "change", "modify", "refactor", "adjust", "tweak" 背景: 提及現有程式碼或元件
流程:onemore-build(直接)
步驟:
- 派發
onemore-build代理處理該任務 - 不需創意總監——正在修改現有程式碼
- 可選:若變動較大,可再派發
onemore-review
路由 3:動畫 / 動態
觸發詞: "animate", "animation", "scroll", "transition", "hover effect", "parallax", "motion", "GSAP", "Framer Motion", "Three.js", "Lottie", "spring"
流程:onemore-animate(專家)
步驟:
- 派發
onemore-animate代理——它擁有深入的動畫知識 - 限縮背景:只載入動畫及工藝物理規則
- 可選:派發
onemore-review進行品質檢查
路由 4:審查 / 稽核
觸發詞: "review", "check", "audit", "quality", "is this good", "what's wrong"
流程:onemore-review(直接)
步驟:
- 對指定的程式碼派發
onemore-review代理 - 它會執行所有檢查表,回報通過/失敗並提供修正
路由 5:無障礙
觸發詞: "accessibility", "a11y", "contrast", "screen reader", "keyboard", "WCAG", "focus", "reduced motion", "VoiceOver"
流程:onemore-a11y(專家)
步驟:
- 派發
onemore-a11y代理——WCAG 2.2 + Apple HIG 無障礙專家 - 它會稽核並自動修復能修復的部分
路由 6:影片參考
觸發詞: 使用者附加影片檔案(.mp4、.mov、.webm、.gif),或說「像這個影片」、「比照這個動畫」、「參考影片」
流程:onemore-analyze → onemore-animate 或 onemore-build
步驟:
- 檢查使用者是否提供背景(目標平台、焦點領域)。若只有影片而無描述——分析代理會在進行前先問一個釐清問題。
- 派發
onemore-analyze代理——使用 Gemini API(若有設定)或 ffmpeg 影格分析 - 產生實作藍圖(blueprint.md + build-prompt.md)
- 使用 build-prompt.md 派發
onemore-animate或onemore-build
與影片一起提供背景時效果最佳:
- 「在 React Native 中重現這個」→ 針對 React Native 的分析
- 「我希望在我的 Next.js 網站上使用這些卷軸動畫」→ 重點分析 GSAP/Framer
- 「萃取出卡片元件的設計」→ 元件專屬分析
路由 7:重新設計
觸發詞: "redesign", "rethink", "reimagine", "redo", "start over"
流程:onemore-vision → [使用者確認簡報] → onemore-build → onemore-review
與路由 1 相同,但創意代理也會讀取現有程式碼以了解正在重新設計的內容。
代理派發參考
| 代理 | 檔案 | 知識 | 角色 |
|---|---|---|---|
onemore-vision | agents/onemore-vision.md | vision-rules.md | 從模糊提示產生創意簡報 |
onemore-build | agents/onemore-build.md | craft + design-system + animation rules | 實作 |
onemore-animate | agents/onemore-animate.md | animation-rules + craft 第 1-3、7 節 | 動態專家 |
onemore-review | agents/onemore-review.md | 所有規則(僅檢查表) | 品質把關 |
onemore-a11y | agents/onemore-a11y.md | design-system 第 9 節、craft 第 12 節 | 無障礙稽核 |
onemore-analyze | agents/onemore-analyze.md | Gemini API + OpenAI API(選用)+ ffmpeg + 動態分析 | 影片參考 → 動態規格 |
派發代理
派發代理時,使用 Agent 工具:
- 從
agents/目錄讀取代理的.md檔案 - 將代理的指示作為提示內容
- 傳遞使用者的請求及任何相關背景(簡報、程式碼路徑、影片路徑)
- 為代理設定適當的工具
派發模式範例:
1. 讀取 agents/onemore-vision.md
2. Agent 工具:prompt = [代理指示] + [使用者請求]
3. 等待代理輸出
4. 呈現給使用者或串聯至下一個代理
Apple HIG 核心原則
這些原則適用於所有代理:
- 清晰 — 文字易讀、圖示精準、裝飾低調
- 順應 — UI 幫助人們理解內容,而不與內容競爭
- 深度 — 視覺層次與擬真動態傳達階層
- 一致性 — 熟悉的標準讓人們能跨應用轉移知識
- 直接操作 — 互動感覺立即,結果可見
- 回饋 — 每個動作都有回應,狀態隨時溝通
優先級規則
| 優先級 | 類別 | 影響 |
|---|---|---|
| 1 | 無障礙與動態字型 | 關鍵 |
| 2 | 觸控目標與安全區域 | 關鍵 |
| 3 | 字體排版(SF Pro/NY 系統) | 高 |
| 4 | 色彩系統(語意、自適應) | 高 |
| 5 | 間距(4pt 格線) | 高 |
| 6 | 元件(原生模式) | 中 |
| 7 | 動畫(彈簧物理) | 中 |
| 8 | 平台專屬模式 | 中 |
快速參考
- 字型堆疊(網頁):
-apple-system, BlinkMacSystemFont, Inter, system-ui, sans-serif - 緩動:
cubic-bezier(0.25, 0.1, 0.25, 1)— Apple 標準(彈簧為佳) - 間距: 4pt 格線 — 4 / 8 / 12 / 16 / 20 / 24 / 32 / 48
- 觸控目標: 最小 44px(visionOS 為 60px)
- 對比: 文字最小 4.5:1
- 內容寬度: 文字 980px,格線 1200px
- 色彩: 絕對不要使用 #000 或 #fff —— 應使用 #1d1d1f 及 #fbfbfd
- 圓角: 連續圓角、同心半徑(內側 = 外側 - 內距)
- 動態: 一律尊重 prefers-reduced-motion
- SF Pro: 僅適用於 Apple 平台——絕不在網頁上提供
反模式
| 反模式 | 修正 |
|---|---|
border-radius: 8px | 連續圓角,符合平台的正確半徑 |
| Arial/Helvetica | SF Pro(原生)、Inter(網頁) |
| 隨機間距 | 4pt 格線 |
| 扁平無生命的 UI | 材質、活力、深度層次 |
ease-in-out | 彈簧物理 |
#000000 文字 | 語意標籤色(#1d1d1f) |
| Emoji 圖示 | SF Symbols 或 Lucide/Heroicons |
| 功能傾銷的登陸頁面 | 故事弧:鉤子 → 問題 → 揭示 → 驚嘆 → 收尾 |
| 所有動畫都一樣 | 編排:交錯、順序、階層 |