开发与工程 react-nativereact-native-tvosandroid-tvfire-tvd-pad-navigationtv-accessibilitydrm-playbackperformance-optimization

React Native TV 应用审查指南

帮助开发者系统排查电视端焦点导航、播放、性能与无障碍问题。

FollowSkills 评估 · FSRS-2.0
不推荐
54/ 100 五分制 2.7 / 5
信任安全16 / 25 · 3.2/5

内容遵循最小化范围,明确区分 TV 栈并包含 DRM 密钥不得放入客户端、令牌由服务器签发等安全建议;未涉及数据收集、外部写入或破坏性操作。因缺少用户确认、回滚方案、完整数据流披露、依赖安全审查和可验证来源,扣分。

可靠稳定8 / 20 · 2.0/5

主文件有清晰的触发条件、栈检测、优先级和问题映射,示例覆盖焦点与无障碍关键路径;但未提供可执行测试套件或异常输入的诊断失败流程,部分平台行为和性能数值缺乏证据。静态校准下不超过10,扣分。

适用触发10 / 15 · 3.3/5

明确面向 Apple TV、Android TV、Fire TV、Vega/Kepler、Tizen 和 webOS,并声明普通 React Native 问题不适用;栈检测和非适用边界较清楚。未说明中文支持或中国大陆网络可达性,且 agent-device 依赖可能限制环境适配,扣分。

规范维护9 / 15 · 3.0/5

具备 YAML 元数据、主题前缀、渐进式参考文件、问题到文件映射、代码示例、检查清单和 MIT 许可;但缺少版本策略、变更日志、维护责任人及明确更新路径,且部分关键参考文件未在证据中展开,扣分。

有效结果7 / 15 · 2.3/5

焦点导航、10-foot 设计、性能、播放/DRM 和无障碍建议具有直接可操作性,问题映射也便于定位;但没有代表性输出、执行验证或与替代方案的比较,静态校准限制最高为7,因此仅给中等分数。

证据核验4 / 10 · 2.0/5

文件本身可审计,包含具体代码、清单、平台分支,并明确区分自动化检查与人工读屏测试;但没有提交测试套件、CI 覆盖关键路径或第三方引用,结论只能有限复核,静态校准下不超过5。

证据充分度: 评估于 2026年7月20日 审查版本 f6b87e35a35c
使用前请注意
  • 本评估仅基于提供的静态文件,未执行任何示例、测试、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 密钥嵌入客户端。

  1. 使用 react-native-tvos 开发 Apple TV、Android TV 或 Fire TV 应用,需要排查焦点跳转、焦点丢失或返回键行为。
  2. 维护包含大量海报和轮播内容的电视应用,需要在低内存设备上检查列表、动画、启动和图片内存压力。
  3. 开发电视视频播放器,遇到清单请求、DRM、编解码器或播放状态错误,需要分层定位问题。
  4. 为 Expo TV、Amazon Vega/Kepler、Tizen 或 webOS 应用检查平台设置、焦点导航和跨平台差异。
  5. 准备电视应用发布,需要覆盖遥控器交互、屏幕阅读器、字幕、焦点顺序、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.gitcp -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 技能;除此之外,提供的资料没有足够信息进行可靠的产品对比。

常见问题

这个技能是否需要付费?
提供的仓库信息显示许可证为 MIT,未提及付费要求。
它能自动修复电视应用吗?
资料描述的是审查、诊断和参考文件路由,没有显示自动修改代码或运行设备测试的能力。
为什么必须先识别电视技术栈?
因为 react-native-tvos、Expo TV、Vega/Kepler 和 Web TV 的安装、构建与焦点方案不同,混用建议会产生误报。
它是否适合普通 React Native 项目?
仅当问题依赖电视端遥控器、焦点、布局、播放、硬件性能或无障碍约束时适用;普通 React Native 问题应使用其他技能。

同仓库的其他 Skills

均来自 callstackincubator/agent-skills

开发与工程

React Native 性能与工程实践指南

为 React Native 和 Expo 应用提供可直接参考的性能与平台优化规则。

开发与工程

React Native 性能优化指南

用可测量的方法定位并优化 React Native 性能问题。

开发与工程

React Native 迁移评估

用证据判断 React Native 迁移是否值得推进

开发与工程

React Navigation 导航构建指南

为 React Native 应用提供 React Navigation 7 导航界面的选型与实现参考。

开发与工程

React Native 棕地迁移助手

帮助原生 iOS 或 Android 应用分阶段接入 React Native 或 Expo。

自动化与运维

React Native GitHub Actions 构建产物

在云端构建 React Native 模拟器产物,并通过 GitHub 工具下载。

开发与工程

移动应用 Dogfood 测试技能

用真实设备系统探索移动应用,并生成带截图和复现步骤的缺陷报告。

开发与工程

React Native 升级助手

通过模板差异、依赖迁移和原生配置调整,帮助 React Native 应用安全升级。

开发与工程

React Native 库搭建助手

用标准脚手架创建可发布或应用内使用的 React Native 库。

开发与工程

React Native 测试助手

帮助 AI 编写可靠的 React Native 组件测试

开发与工程

跨平台设备交互助手

让 AI 编程助手能够检查并操作 Apple 与 Android 应用设备。

开发与工程

技能规范校验器

检查 Agent Skill 是否符合规范与 Claude Code 最佳实践。

开发与工程

GitHub PR 工作流助手

用 gh CLI 管理 PR、堆叠分支与代码合并流程。

相关 Skills