tvos-design-guidelines

tvos-design-guidelines 技能概览

tvos-design-guidelines 技能是一套面向 Apple TV 的实用设计规则，适合正在构建或评审 tvOS 界面的团队。它能帮助你在上线前判断一个屏幕、导航流程或播放界面在沙发前是否真的可用。如果你需要用 tvos-design-guidelines 做 UI Design，当焦点移动、Siri Remote 行为、10 英尺可读性或媒体控制才是核心风险时，这套技能最合适。

这项技能最适合什么场景

当你在设计 tvOS 应用、审查现有 Apple TV 界面，或者为需要推理基于焦点导航的模型编写提示词时，tvos-design-guidelines 都很适用。它尤其适合 checkout 式评估、逐屏评审，以及那种“小交互失误会带来大可用性问题”的实现指导场景。

它为什么不同于通用提示词

普通设计提示词可能会提到“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 设计约束最集中的位置在哪里。

给它任务，不要只给主题

这项技能最适合输入里明确写出屏幕、用户目标和平台上下文。弱输入示例：Review this Apple TV app. 强输入示例：Review the movie detail screen for tvOS and check focus order, default focus, remote back behavior, and whether metadata remains readable at 10-foot distance. 这样的提示能让 tvos-design-guidelines 的用法更具体，也更可执行。

提示词里应该包含什么

提供布局类型、主要操作、任何媒体播放行为，以及这个界面是新设计还是重设计。如果相关，再补充诸如 top shelf 支持、可访问性需求或自定义焦点移动之类的限制。你对交互路径描述得越清楚，技能就越容易判断设计是否符合 tvOS design guidelines 的安装假设。

提高输出质量的实用流程

先给一个粗略提示，再让它做基于规则的评审，最后再让它给出修改方案。比如：Evaluate this screen against tvOS focus rules, list violations by severity, then rewrite the interaction model. 这种步骤通常比一步直接要最终设计更有效，因为技能可以先暴露问题，再进入修正阶段。

tvos-design-guidelines 技能 FAQ

这只适用于 Apple TV 应用设计吗？

是的。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 技能

提供更精确的屏幕上下文

最好的结果来自能明确指出具体屏幕和状态的提示词：浏览页、详情页、播放浮层、设置页或引导页。请写清楚用户想完成什么、哪些内容可选，以及焦点一开始应该落在哪里。这样的上下文能让技能更精准地应用 tvos-design-guidelines，而不是给出泛泛建议。

尽早暴露常见失败模式

明确要求它检查焦点陷阱、无法触达的控件、含糊的选择状态，以及任何焦点可能跳出布局的地方。如果屏幕里有网格、轮播或混合内容，也要说明；这些模式正是 tvOS 输出最容易出问题的地方。

按约束迭代，不要按审美迭代

如果第一次回答太宽泛，下一轮就收窄范围，要求它输出三种内容之一：规则违规清单、修订后的焦点地图，或遥控交互审计。这样会更好地发挥 tvos-design-guidelines 的作用，因为技能可以针对具体问题进行修正，而不是重新解释整个平台。

把仓库参考当作检查清单

如果要做更深入的打磨，可以把答案与 rules/_sections.md 和 metadata.json 对照。这些文件在你想确认严重程度、识别关键分类，或把技能转成内部 tvOS 评审清单时都很有用。