这个 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、测试和关键用户流程验证。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js/npmcurlgrepCocoaPodsXcode xcodebuildReact Native CLI
仓库 README 记录了手动安装方式:先执行 git clone https://github.com/callstackincubator/agent-skills.git,再将 agent-skills/skills/* 复制到项目的 .codex/skills/,或复制到用户级 ~/.codex/skills/。重启 Codex 后识别新技能。该仓库也提供 Codex 插件市场元数据。
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?
文档要求先确认目标应用、在依赖迁移存在歧义时征得用户确认,并记录手工偏差;但包含sudo、网络下载、依赖安装和原生构建等外部影响,未充分说明数据流、凭据处理、权限边界或回滚方案,因此扣9分。
流程分层清晰,包含版本对、停止条件、安装和验证门槛,静态上可复现性较好;但存在硬编码App scheme、部分命令缺少失败控制,且未提供针对关键路径的测试或异常反馈模板,按静态上限扣分。
触发场景、Expo条件、单仓库/monorepo边界和APP_DIR约束较明确;但未声明更多非适用范围,中文支持未说明,并依赖npm、GitHub、Upgrade Helper及Apple/Android工具链,国内网络可达性存在不确定性,扣4分。
主文档采用路由、参考文件和问题映射的渐进式结构,含MIT许可证、示例和限制性停止条件;但缺少技能版本、变更记录、明确维护责任与更新路径,作者信息也不足以证明治理完整,扣5分。
覆盖依赖、React、Expo、iOS、Android及验证流程,核心升级任务的操作价值较高;但升级结果仍需项目特定合并、人工判断和双平台验证,静态审查无法证明可直接完成任务,因此按上限7分评分。
提供rn-diff-purge、Upgrade Helper、Expo和React Native等可审计来源,并要求记录验证证据;但当前材料没有技能专属测试、CI覆盖或已执行结果,无法超过静态上限5分。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →