visionos-design-guidelines

visionos-design-guidelines 技能總覽

這個技能是用來做什麼的

visionos-design-guidelines 技能可協助你套用 Apple Vision Pro 的設計規範，當你需要判斷空間式 UI 要怎麼排版、眼動與手勢輸入該如何運作，或某個沉浸式概念是否符合 visionOS 慣例時，這個技能特別有用。它最適合的情境，不只是想找靈感，而是需要會影響舒適度、可達性與平台正確性的設計限制。

適合誰安裝

如果你正在設計或審閱 visionOS app、RealityKit 體驗、volume、以視窗為基礎的介面，或混合實境原型，就應該安裝 visionos-design-guidelines。它尤其適合 UI 設計師、產品工程師，以及需要產出可直接落地實作建議、而不是泛泛一句「做得更沉浸一點」的 AI agent。

它的特色在哪裡

這個技能重點不在廣泛的產品理論，而在實務上的護欄：內容該放哪裡、怎麼處理 gaze 加 pinch 的互動、哪些元素不能 head-lock，以及如何避免舒適性或可及性上的錯誤。當你需要在動手建置前，快速依照關鍵空間規則做一次設計檢查時，visionos-design-guidelines 技能最有價值。

如何使用 visionos-design-guidelines 技能

安裝並載入正確脈絡

先透過你的 skills manager 使用 visionos-design-guidelines install 流程，然後先閱讀 skill 條目的這些檔案：SKILL.md、AGENTS.md、metadata.json 和 rules/_sections.md。這個技能不依賴 scripts，因此它的價值主要來自規則集與分類摘要。

先提供具體的空間式需求

visionos-design-guidelines usage 在你的提示詞包含介面類型、使用者目標與實體情境時，效果最好。好的輸入像是：「為一個 productivity app 設計 visionOS onboarding flow，使用一個 window 和一個 ornament」，或「審查這個沉浸式 dashboard 的舒適性、目標尺寸，以及眼動／手勢互動風險。」像「把這個做得更 Apple 一點」這類模糊輸入，通常只會得到很泛的回答。

把粗略想法改寫成更好的提示

在 visionos-design-guidelines for UI Design 中，最好加入：

• app 載體：window、volume、immersive space，或混合式版面
• 主要任務：閱讀、選取、操作、導覽，或狀態顯示
• 互動模型：gaze、pinch、drag、手勢、語音，或混合輸入
• 限制條件：固定視窗數量、可及性需求、舒適性限制，或既有的 RealityKit 程式碼

更強的提示例如：「請依 visionOS 規範，從眼睛疲勞、視野內位置，以及控制元件尺寸三個角度審視這個雙欄 dashboard，然後把它改寫成更符合空間舒適性的版面。」

依照這個順序閱讀檔案

把 visionos-design-guidelines guide 當作一條 repository 閱讀路徑：

1. rules/_sections.md：看依嚴重程度排序的規則地圖
2. SKILL.md：看詳細規則與反模式
3. AGENTS.md：看用途、範圍與使用提示
4. metadata.json：看參考來源與版本脈絡

如果時間有限，先從最關鍵的類別開始：空間排版、眼動與手勢輸入，以及可及性。

visionos-design-guidelines 技能 FAQ

這只適用於 Apple Vision Pro 嗎？

大致上是。visionos-design-guidelines 技能的核心是 visionOS 與 Apple Vision Pro 的設計慣例，但這些規則對任何使用 gaze、手勢輸入或 world-anchored 版面的空間運算 UI 也很有參考價值。

它和一般提示詞有什麼不同？

一般提示詞可能只給你風格層面的答案；這個技能則提供的是基於規則的設計視角：距離、位置、目標尺寸、hover 回饋、可及性覆蓋，以及沉浸程度邊界。這讓它在審查、實作，以及避免平台特定錯誤時更好用。

對初學者友善嗎？

友善，只要你能描述想要的畫面或體驗即可。使用 visionos-design-guidelines 不需要很深的 visionOS 知識，但你必須提供足夠脈絡，讓技能能準確判斷空間排版與互動模式。

什麼情況下不該用？

不要把它拿來做一般行動裝置 UI、純網頁介面，或非空間式的產品文案。若你的需求是直接產生程式碼而不是設計審查，或任務中完全沒有 visionOS、RealityKit、或混合實境成分，也不是它的適用範圍。

如何改進 visionos-design-guidelines 技能

提供真實的介面形狀

品質提升最大的一步，就是講清楚畫面上有什麼，以及它在空間中的位置。請說明你的是單一 window、多個 windows、漂浮的 volume，還是沉浸式場景，並補充使用者在前 5 秒內必須做什麼。

把會改變答案的限制條件講出來

visionos-design-guidelines 在你一開始就提到舒適性、可及性與輸入限制時，表現會更好。請把最低目標尺寸、介面是否必須支援 VoiceOver 或 pointer control，以及設計是否要避免頻繁頭部移動等條件一起寫清楚。

先要求批判，再要求重寫

一個很實用的流程是：先請它找出規則違規處，再請它給修正版。例如：「請依舒適性、gaze 回饋與可及性規則，檢查這個 visionOS onboarding；然後重寫版面與互動流程。」這通常比直接要求一個泛用設計，更容易得到可執行的結果。

用第一輪答案縮小下一輪範圍

如果第一次結果太發散，就按類別縮小：空間排版、眼動與手勢輸入、視窗，或可及性。visionos-design-guidelines 技能在你一次只修正一種失敗模式時最容易進步，例如內容擺位、hover 狀態，或 world anchoring。