tvos-design-guidelines

tvos-design-guidelines 技能概覽

tvos-design-guidelines 技能是一套實用的 Apple TV 設計規則，適合用來協助團隊建構或審查 tvOS 介面。它能幫你在發佈前判斷一個畫面、導覽流程或播放 UI，到了沙發上是否真的可用。若你需要用 tvos-design-guidelines 技能來做 UI Design，當焦點移動、Siri Remote 行為、10 呎可讀性，或媒體控制才是真正風險時，這個技能就很適合。

這個技能最適合的情境

當你在設計 tvOS App、稽核既有的 Apple TV 介面，或撰寫必須推理焦點式導覽的模型提示時，最適合使用 tvos-design-guidelines。它特別適合用在下單式評估、逐畫面檢視，以及實作建議這類情境，因為些微的互動失誤就可能造成嚴重的可用性問題。

它和一般提示詞的不同之處

一般設計提示詞可能會提到「Apple TV」，卻忽略最重要的限制：沒有游標、沒有觸控、焦點順序必須可預期，而且控制方式必須以遙控器為先。這份 tvos-design-guidelines 指南會在一開始就把這些限制放到核心位置，因此輸出內容比較不容易建議出在 tvOS 上會失敗的手機式模式。

它要處理的主要導入風險

最大的阻礙通常是焦點陷阱、不清楚的選取狀態、破壞預期導覽的遙控器行為，以及在螢幕上看起來沒問題、到了客廳距離卻失效的版面。當你想要的是能在實作前先抓出這些問題的規則式建議時，這個技能最強。

如何使用 tvos-design-guidelines 技能

安裝後先從核心檔案開始

使用 npx skills add ehmo/platform-design-skills --skill tvos-design-guidelines 安裝。接著先讀 SKILL.md，再讀 AGENTS.md、metadata.json 和 rules/_sections.md。這些檔案會告訴你這個技能的最佳化方向、哪些規則最關鍵，以及 tvOS 設計限制最強的地方在哪裡。

下任務，不要只給主題

這個技能在你的輸入明確指出畫面、使用者目標與平台情境時，效果最好。弱的輸入像是：「幫我檢視這個 Apple TV app。」強的輸入像是：「檢視 tvOS 的電影詳情頁，確認焦點順序、預設焦點、遙控器返回行為，以及中 10 呎距離時中繼資料是否仍可讀。」這種提示會讓 tvos-design-guidelines 的使用變得具體且可操作。

提示詞應包含哪些內容

請提供版面類型、主要操作、任何媒體播放行為，以及這個畫面是全新設計還是重新設計。如果相關，也請提到像是 top shelf 支援、無障礙需求，或自訂焦點移動等限制。你對互動路徑描述得越完整，技能就越容易判斷設計是否符合 tvOS 設計指南的安裝前提。

讓輸出更好的實務流程

先用一個粗略提示詞開始，接著請它做規則式審查，再請它提出修正建議。比方說：「依照 tvOS 焦點規則評估這個畫面，按嚴重度列出違規項目，然後重寫互動模型。」這種順序通常比一步到位要求最終設計更好，因為技能可以先揭露缺口，再讓你要求補救。

tvos-design-guidelines 技能 FAQ

這個技能只適用於 Apple TV app 設計嗎？

是。tvos-design-guidelines 技能聚焦在 tvOS 互動模式，對 Apple TV 介面、焦點導覽，以及客廳觀看限制最有價值。如果你的產品不依賴遙控器驅動的導覽，這份指南就會比一般 UI Design 提示詞沒那麼有幫助。

它會取代 Apple 的 HIG 嗎？

不會。它是在 Apple Human Interface Guidelines 之上的實作層，不是替代品。當你想要更快、也更偏實務的 tvos-design-guidelines 指南，能把 HIG 概念轉成設計與實作檢查時，就很適合用它。

對初學者友善嗎？

大致上是，因為最高價值的規則都很具體：焦點必須可見、移動必須可預期、遙控器操作必須保持簡單。初學者會受益於它能減少猜測，但如果你至少懂一些基本 tvOS 名詞，例如 focus、top shelf 和 Siri Remote，會更有幫助。

什麼情況下不該使用它？

不要把它用在以觸控為主的 iPhone 或 iPad 版面，也不要用在焦點導覽不是核心問題的一般 UI 工作。如果你需要的是品牌策略或動態概念，而且完全沒有平台限制，這個技能就不太合適，因為它是為了 tvos-design-guidelines 的安裝決策與實作審查而設計的。

如何改進 tvos-design-guidelines 技能

提供更精準的畫面情境

最好的結果來自明確指定畫面與狀態的提示詞：瀏覽頁、詳情頁、播放浮層、設定頁，或 onboarding。請包含使用者想做什麼、哪些元素可選，以及焦點應該先落在哪裡。這些情境能讓技能更精準地套用 tvos-design-guidelines，而不是只給泛泛建議。

盡早暴露常見失敗模式

請明確詢問焦點陷阱、無法抵達的控制項、模糊的選取狀態，以及焦點可能在版面間跳躍的地方。如果畫面裡有格狀列表、輪播，或混合內容，也請直接說明；這些正是 tvOS 輸出最常出問題的模式。

用限制條件迭代，不要用美感迭代

如果第一個答案太廣泛，就用下一輪提問縮小範圍，改問三種內容之一：規則違規清單、修正版焦點地圖，或遙控器互動稽核。這樣能改善 tvos-design-guidelines 的使用效果，因為技能可以修正特定問題，而不是重新解釋整個平台。

把 repo 參考檔當成檢查清單

若要更深入地精修，可將答案與 rules/_sections.md 和 metadata.json 對照。當你想確認嚴重度、找出關鍵類別，或把這個技能變成內部 tvOS 審查檢查清單時，這些檔案都很有用。