用途
该工作流用于指导 tvOS 应用在通用 SwiftUI 架构之外、与 Apple TV 平台强相关的体验决策，包括：遥控器/控制器的间接输入、可见的焦点移动、大屏布局、大字体、硬件与 SDK 可用性判断，以及从 TVMLKit 迁移。其原则是保持 SwiftUI 作为主要 UI 路径，只有在存在明确的几何或生命周期约束证据时，才使用 UIKit 焦点 API。
适用场景
- tvOS 目录、工具、教育、健身、游戏相关或媒体浏览类应用，核心问题在于遥控器优先交互或焦点行为。
- SwiftUI 内容货架（content shelves）、lockup、悬停效果、focusSection()、聚焦项裁切、焦点恢复或大屏布局决策。
- UIFocusGuide、UIFocusEnvironment、首选焦点环境、焦点更新诊断，或 UIKit/SwiftUI 焦点边界问题。
- tvOS 27 大字体/动态字体适配、遥控器与控制器的输入差异、文字输入负担、Apple TV 硬件/GPU 能力门槛、测试版 SDK 可用性问题。
- 对 TVMLKit 应用做清单盘点并规划迁移到 SwiftUI 或 UIKit（TVMLKit 自 tvOS 18 起已弃用）。
主要能力与工作流程
首先对请求分类：SwiftUI 优先的内容布局、焦点路由或恢复、UIKit 焦点补充方案、大字体或无障碍适配、能力或测试版 SDK 门槛、TVMLKit 迁移盘点。随后执行 Apple 文档检查：先阅读当前 Apple 文档，明确所依赖的焦点、输入、可用性或弃用行为，再提出变更；对 tvOS 27 相关主张标注为测试版并记录所查 SDK/构建日期，直到 Apple 发布 GM 版。
在实现层面，选择最小的原生 UI 界面：常规目录布局优先使用 SwiftUI 的 Button、focusSection()、lockup、悬停效果和滚动行为；为焦点缩放和抬升保留足够空间；仅在原生几何无法产生预期移动时使用 UIFocusGuide 或首选焦点环境。
平台边界检查包括：Siri Remote、控制器、语音或配套设备输入；焦点、选择、Menu/Back 与恢复行为；文字输入替代方案与遥控器操作摩擦；Apple TV 代际、GPU 家族、仅模拟器/仅设备要求及不可用框架；大字体、RTL、VoiceOver 顺序和视觉焦点状态。
输出与判定
状态分为 success（体验建议已就绪）、handoff（由其他技能接手下一步）、blocked（能力、运行时或文档证据不足，无法作出所需结论）。路径类型分为 primary（原生 SwiftUI 焦点/布局指导已足够）与 fallback（需要 UIKit 焦点 API、设备证据或迁移盘点）。输出内容包含请求分类、所依赖的 Apple 文档行为、焦点/布局或迁移建议、平台与测试版边界、验证预期与交接项。
限制与边界
不把 Siri Remote 的移动视为触屏坐标，也不在选定方向上直接驱动焦点移动，方向性移动由焦点系统负责。不为普通 tvOS 菜单添加指针驱动的导航模型。不让聚焦的 lockup 在被缩放和抬升时裁切、遮挡控件或丢失可读标题。不让大量打字交互成为 TV 体验的唯一路径。在没有当前文档及必要设备证据时不宣称某框架、Apple Intelligence 能力、GPU 特性、控制器行为或 tvOS 27 测试版行为可用。不为 TVMLKit 新增功能，只做盘点并迁移。不宣称 tvOS 支持直接使用 Core AI、SystemLanguageModel 或 Foundation Models 推理，运行时选择需连同 tvOS 可用性限制一并交由模型运行时相关技能处理。
交接建议
播放 UI、遥控器传输命令、Now Playing、AVKit 定制、HLS 或自定义播放器交给 tvos-media-playback-workflow；常规场景、状态、组件归属交给 swiftui-app-architecture-workflow；语义无障碍与无障碍树审查交给 apple-ui-accessibility-workflow；通用 AVFoundation 处理交给 avfoundation-media-pipeline-workflow；项目构建、启动与设备跟进交给 xcode-build-run-workflow，运行时 UI 验证与 XCUITest 规划交给 xcode-testing-workflow；需要当前 Apple 文档本身时交给 explore-apple-swift-docs。
参考资料与输入
工作流参考文档包括 references/focus-layout-and-input.md、references/platform-beta-and-migration.md、references/validation-expectations.md。可选输入有 request（自由文本 tvOS 任务）、scope（layout、focus、uikit-focus、large-text、capability、tvmlkit-migration、review）、framework_context（swiftui、uikit、mixed、unknown）、target_context（Apple TV 代际、tvOS 部署目标、遥控器/控制器需求、是否面向测试版）。默认规则：始终以文档优先，SwiftUI 为主实现路径，方向性焦点由用户控制，tvOS 27 行为保持测试版限定直到 GM 版重新验证。