React Native TV 应用审查指南
帮助开发者系统排查电视端焦点导航、播放、性能与无障碍问题。
内容遵循最小化范围,明确区分 TV 栈并包含 DRM 密钥不得放入客户端、令牌由服务器签发等安全建议;未涉及数据收集、外部写入或破坏性操作。因缺少用户确认、回滚方案、完整数据流披露、依赖安全审查和可验证来源,扣分。
主文件有清晰的触发条件、栈检测、优先级和问题映射,示例覆盖焦点与无障碍关键路径;但未提供可执行测试套件或异常输入的诊断失败流程,部分平台行为和性能数值缺乏证据。静态校准下不超过10,扣分。
明确面向 Apple TV、Android TV、Fire TV、Vega/Kepler、Tizen 和 webOS,并声明普通 React Native 问题不适用;栈检测和非适用边界较清楚。未说明中文支持或中国大陆网络可达性,且 agent-device 依赖可能限制环境适配,扣分。
具备 YAML 元数据、主题前缀、渐进式参考文件、问题到文件映射、代码示例、检查清单和 MIT 许可;但缺少版本策略、变更日志、维护责任人及明确更新路径,且部分关键参考文件未在证据中展开,扣分。
焦点导航、10-foot 设计、性能、播放/DRM 和无障碍建议具有直接可操作性,问题映射也便于定位;但没有代表性输出、执行验证或与替代方案的比较,静态校准限制最高为7,因此仅给中等分数。
文件本身可审计,包含具体代码、清单、平台分支,并明确区分自动化检查与人工读屏测试;但没有提交测试套件、CI 覆盖关键路径或第三方引用,结论只能有限复核,静态校准下不超过5。
- 本评估仅基于提供的静态文件,未执行任何示例、测试、CI 或设备验证。
- 部分平台 API、版本行为、性能阈值和无障碍要求未附来源,使用前应在目标设备和当前官方文档中复核。
- 核心参考文件仅部分提供,未展示文件中的断言不能视为已验证。
- 未说明中文内容或中国大陆网络环境下的使用适配;agent-device 相关流程可能依赖额外环境能力。
这个 Skill 能做什么,适合哪些场景?
这是一个面向 React Native 电视应用的审查型 Agent Skill,覆盖 Apple TV、Android TV、Fire TV、Amazon Vega/Kepler 以及 Tizen、webOS 等 Web TV 目标。它重点处理遥控器与 D-pad 输入、焦点管理、10 英尺界面、视频播放与 DRM、低内存硬件性能和电视无障碍。使用前应先识别应用所采用的电视技术栈,因为安装和构建建议具有平台差异。该技能只处理电视特有问题,普通 React Native 性能或架构问题应交给其他技能。
指导助手检查项目的 package.json、Manifest、原生目录和平台工具,以识别电视技术栈;按优先级审查焦点移动、D-pad 导航、列表与动画性能、视频协议和 DRM、10 英尺布局、无障碍、测试及发布流程;将常见症状映射到对应的 references/*.md 文件;要求从网络/DRM、解码器、播放器状态和 React 控件等层次区分播放故障,并提醒不要把 FairPlay、Widevine 或 PlayReady 密钥嵌入客户端。
- 使用 react-native-tvos 开发 Apple TV、Android TV 或 Fire TV 应用,需要排查焦点跳转、焦点丢失或返回键行为。
- 维护包含大量海报和轮播内容的电视应用,需要在低内存设备上检查列表、动画、启动和图片内存压力。
- 开发电视视频播放器,遇到清单请求、DRM、编解码器或播放状态错误,需要分层定位问题。
- 为 Expo TV、Amazon Vega/Kepler、Tizen 或 webOS 应用检查平台设置、焦点导航和跨平台差异。
- 准备电视应用发布,需要覆盖遥控器交互、屏幕阅读器、字幕、焦点顺序、E2E 测试和 CI 检查。
这个 Skill 有哪些优点和局限?
- 覆盖焦点、导航、10 英尺设计、性能、视频/DRM、无障碍、测试和发布等电视端关键问题。
- 明确区分 react-native-tvos、Expo TV、Vega/Kepler 和 Web TV 的设置要求,能减少错误的平台建议。
- 提供按影响等级排序的审查规则、快速参考、问题到参考文件的映射和安全提示。
- 采用 MIT 许可证,并作为包含 14 个独立技能的开源仓库发布。
- 资料重点是审查指导,不是可执行脚本、自动修复工具或设备测试框架。
- 给出的内容未证明在具体电视型号、模拟器或真实 DRM 服务上经过测试。
- 完整细节依赖仓库中的 references 文件;当前提供的资料未包含这些文件的正文。
- 只覆盖电视特有差异,普通 React Native 性能和架构问题不在本技能范围内。
如何安装这个 Skill?
源码提供的手动安装方式是先克隆仓库,再把技能目录复制到项目级 .codex/skills/ 或用户级 ~/.codex/skills/:git clone https://github.com/callstackincubator/agent-skills.git;cp -r agent-skills/skills/react-native-tv-best-practices .codex/skills/。README 也说明可将整个 skills/ 目录复制到这些位置。重启 Codex 后识别新技能。
如何使用这个 Skill?
在支持 Agent Skills 的编码助手中,让助手读取 skills/react-native-tv-best-practices/SKILL.md,或直接提出具体任务,例如:Review this react-native-tvos app for focus restoration, D-pad navigation, and low-memory performance on Fire TV. 使用前提供项目的 package.json、Manifest、原生目录和平台配置,以便识别技术栈。源码没有规定专用命令、脚本或自动化执行接口。
这个 Skill 与同类方案有什么区别?
它明确建议普通 React Native 性能或架构问题使用同仓库的 react-native-best-practices 技能;除此之外,提供的资料没有足够信息进行可靠的产品对比。