开发与工程

React Native 升级助手

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

58/ 100
推荐

整体可靠,存在已披露的局限;按说明试用并保留回滚路径。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 1.7k
最近更新
18 天前
License
MIT
react-nativeupgrade-helpercocoapodsgradle
+2expo-sdkdependency-migration

这个 Skill 能做什么,适合哪些场景?

该技能面向需要升级 React Native 或 Expo SDK 的开发者。它将升级流程拆分为版本路径选择、Upgrade Helper 模板差异、第三方依赖评估、React 对齐、Expo 适配和升级后验证。内容覆盖 package.json、iOS CocoaPods、Android Gradle 及常见破坏性 API 变更。它适合希望按步骤处理原生配置和依赖风险的 React Native 项目,但源材料没有提供测试套件或已验证的平台清单。

读取项目中的 React Native 版本,查询最新版本,下载 rn-diff-purge 的版本模板差异,列出差异文件,指导更新 package.json 依赖、应用 iOS 和 Android 原生配置变更、运行 npm install 与 pod install,并使用 Android 构建和 xcodebuild 命令进行验证。

适合
  • 负责维护 React Native 应用、需要从一个 0.x 版本升级到更高版本的开发者。
  • 需要根据 Upgrade Helper 模板差异调整 iOS 和 Android 原生配置的团队。
  • 升级 React Native 后需要评估第三方依赖兼容性和迁移风险的项目。
  • 同时迁移 Expo SDK 与 React Native 版本的 Expo 项目维护者。

如何安装这个 Skill?

使用前请注意
  • 执行前应确认APP_DIR、版本对、包管理器和目标平台,避免误改workspace根目录或错误应用。
  • sudo xcode-select和xcodebuild命令具有系统级影响,应由用户明确授权并准备可恢复的环境。
  • curl、npm view、Expo命令及外部参考依赖网络;中国大陆网络可达性和第三方内容稳定性未被文档保证。
  • 不要把示例中的App scheme、路径或版本号直接套用到项目;升级完成必须由项目方执行并记录iOS、Android、测试和关键用户流程验证。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • Node.js/npm
  • curl
  • grep
  • CocoaPods
  • Xcode xcodebuild
  • React Native CLI

仓库 README 记录了手动安装方式:先执行 git clone https://github.com/callstackincubator/agent-skills.git,再将 agent-skills/skills/* 复制到项目的 .codex/skills/,或复制到用户级 ~/.codex/skills/。重启 Codex 后识别新技能。该仓库也提供 Codex 插件市场元数据。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/callstackincubator/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/upgrading-react-native" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

试试这样说

安装后,把下面任意一句发给 Agent 即可触发:

  • 将此应用从 React Native 0.76.9 升级到 0.78.2,并检查 iOS、Android、依赖和 Expo 影响

在已安装技能的 React Native 项目中,用类似“将此应用从 React Native 0.76.9 升级到 0.78.2,并检查 iOS、Android、依赖和 Expo 影响”的请求触发。技能给出的示例流程包括查询当前版本、下载 Upgrade Helper 差异、审查变更、安装依赖、运行 pod install,以及分别验证 Android 和 iOS 构建。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖从版本路由到构建验证的完整升级流程。
  • 明确包含第三方依赖、React、Expo SDK、CocoaPods 和 Gradle 等常见升级环节。
  • 提供可复制的版本查询、差异下载和构建验证命令。
局限
  • 源材料未展示自动修改文件的脚本或测试套件。
  • 示例依赖 Node.js/npm、网络访问、CocoaPods、Xcode 和 Android 构建环境。
  • 源材料没有给出已验证的操作系统、React Native 版本范围或成功率数据。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
React Native 升级助手 本页 58 · 推荐 ★ 1.7k 18 天前 MIT
Expo SDK 升级助手 50 · 谨慎使用 ★ 2.9k 21 天前 MIT
React Native 棕地迁移助手 53 · 谨慎使用 ★ 1.7k 18 天前 MIT
Expo Web 转原生迁移指南 52 · 谨慎使用 ★ 2.9k 21 天前 MIT
Google Mobile Ads Next-Gen 迁移助手 ✓ Google · 官方 46 · 谨慎使用 ★ 21k 12 天前 Apache-2.0

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
推荐
58/ 100 五分制 2.9 / 5
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
1信任安全16 / 25 · 3.2/5

文档要求先确认目标应用、在依赖迁移存在歧义时征得用户确认,并记录手工偏差;但包含sudo、网络下载、依赖安装和原生构建等外部影响,未充分说明数据流、凭据处理、权限边界或回滚方案,因此扣9分。

2可靠稳定9 / 20 · 2.3/5

流程分层清晰,包含版本对、停止条件、安装和验证门槛,静态上可复现性较好;但存在硬编码App scheme、部分命令缺少失败控制,且未提供针对关键路径的测试或异常反馈模板,按静态上限扣分。

3适用触发11 / 15 · 3.7/5

触发场景、Expo条件、单仓库/monorepo边界和APP_DIR约束较明确;但未声明更多非适用范围,中文支持未说明,并依赖npm、GitHub、Upgrade Helper及Apple/Android工具链,国内网络可达性存在不确定性,扣4分。

4规范维护10 / 15 · 3.3/5

主文档采用路由、参考文件和问题映射的渐进式结构,含MIT许可证、示例和限制性停止条件;但缺少技能版本、变更记录、明确维护责任与更新路径,作者信息也不足以证明治理完整,扣5分。

5有效结果7 / 15 · 2.3/5

覆盖依赖、React、Expo、iOS、Android及验证流程,核心升级任务的操作价值较高;但升级结果仍需项目特定合并、人工判断和双平台验证,静态审查无法证明可直接完成任务,因此按上限7分评分。

6证据核验5 / 10 · 2.5/5

提供rn-diff-purge、Upgrade Helper、Expo和React Native等可审计来源,并要求记录验证证据;但当前材料没有技能专属测试、CI覆盖或已执行结果,无法超过静态上限5分。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 f6b87e35a35c 评估证据[1][2][3][4][5][6][7][8][9][10][11][12]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能是否收费?
源材料标明许可证为 MIT,未列出使用费用。
它会自动完成所有升级修改吗?
源材料说明它通过差异、依赖和验证流程指导升级,但没有证明存在自动完成全部文件修改的机制。
升级失败时会处理哪些问题?
它覆盖模板差异、依赖兼容性、原生 iOS/Android 配置、CocoaPods、Gradle 和破坏性 API 更新;具体失败原因仍需结合项目检查。
它适合哪些项目?
适合升级 React Native,或在相关场景中同步迁移 Expo SDK 的应用;不应将仓库其他技能的能力视为本技能范围。

同仓库的其他 Skills

均来自 callstackincubator/agent-skills

开发与工程

React Native 棕地迁移助手

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

★ 1.7k FS 53 谨慎使用 18 天前
开发与工程

React Native 性能优化指南

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

★ 1.7k FS 60 推荐 18 天前
开发与工程

React Native 迁移评估

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

★ 1.7k FS 57 谨慎使用 18 天前
开发与工程

React Native 性能与工程实践指南

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

★ 1.7k FS 51 谨慎使用 18 天前
开发与工程

React Navigation 导航构建指南

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

★ 1.7k FS 57 谨慎使用 18 天前
开发与工程

React Native TV 应用审查指南

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

★ 1.7k FS 54 谨慎使用 18 天前
开发与工程

React Native 库搭建助手

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

★ 1.7k FS 50 谨慎使用 18 天前
自动化与运维

React Native GitHub Actions 构建产物

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

★ 1.7k FS 49 谨慎使用 18 天前
开发与工程

移动应用 Dogfood 测试技能

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

★ 1.7k FS 46 谨慎使用 18 天前
开发与工程

React Native 测试助手

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

★ 1.7k FS 54 谨慎使用 18 天前
开发与工程

跨平台设备交互助手

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

★ 1.7k FS 58 推荐 18 天前
开发与工程

技能规范校验器

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

★ 1.7k FS 45 不推荐 18 天前
开发与工程

GitHub PR 工作流助手

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

★ 1.7k FS 42 不推荐 18 天前

相关 Skills