upgrading-react-native

upgrading-react-native skill の概要

この skill でできること

upgrading-react-native skill は、React Native のバージョンアップを、一般的なプロンプトよりも迷い少なく計画・実行するための skill です。実際の作業に焦点を当てており、正しいアップグレード経路の選定、rn-diff-purge / Upgrade Helper の差分適用、依存関係の整合、ビルドを壊しやすい iOS と Android の変更対応までカバーします。

どんな人向けか

React Native アプリで Frontend Development を行っていて、ある RN リリースから別のリリースへ移行する必要があるなら、upgrading-react-native skill が向いています。特に、native フォルダ、CocoaPods、Gradle、Expo SDK の互換性が絡むケースで有効です。単発の「version を上げればいい？」ではなく、再現性のあるアップグレード手順が必要なメンテナーに最適です。

何が便利なのか

最大の価値は、作業フローのガイドにあります。アップグレードの順序づけ、アプリ固有の変更と依存関係の作業の切り分け、よくある失敗箇所の早期検出を助けます。package.json を書き換えるだけの作業ではなく、native code を含む既存アプリをアップグレードしたいときに特に強みがあります。

upgrading-react-native skill の使い方

インストールして起動する

エージェント skill コマンドでは、upgrading-react-native install の流れで次を使います。
npx skills add callstackincubator/agent-skills --skill upgrading-react-native

その後、現在のバージョンと目標バージョン、アプリ構成、特別な制約を含めたプロンプトで呼び出します。たとえば: 「upgrading-react-native skill を使って、monorepo のアプリを RN 0.76.9 から 0.78.2 に上げてください。アプリは apps/mobile にあり、Expo を使っていて、iOS と Android のビルドを常に green に保つ必要があります。」

必要な入力を正しく渡す

この skill は、次の情報を入れると最もよく機能します。

• 現在の React Native バージョンと目標バージョン
• Expo か bare RN か
• リポジトリ構成: 単一アプリか monorepo か
• package manager と native build の構成
• Custom native modules、CodePush、厳格な CI ルールなど、既知の制約や障害

単に「RN をアップグレードして」とだけ伝えると、出力はかなり一般的になります。バージョン、アプリのパス、制約まで含めれば、差分や依存関係の判断をより正確にマッピングできます。

先に読むべきファイル

upgrading-react-native の使い方としては、まず次を確認してください。

• アップグレード手順は SKILL.md
• 差分ベースのワークフローは references/upgrade-helper-core.md
• アプリが repo 直下にない場合は references/monorepo-singlerepo-targeting.md
• package の互換性確認は references/upgrading-dependencies.md
• Expo がある場合は references/expo-sdk-upgrade.md
• アップグレード後の検証は references/upgrade-verification.md

この読み順が重要なのは、ターゲットアプリと依存関係の範囲が明確になる前にアップグレード差分を当ててしまう、というよくある失敗を防げるからです。

実践的な進め方

優れた upgrading-react-native のガイドは、通常次の流れで進みます。

1. アプリ package と正確な RN バージョンを特定する
2. 関連する template diff を取得する
3. package 依存関係と companion package を更新する
4. iOS と Android の native 設定変更を適用する
5. build と verification を実行する
6. 1 回目で出た breaking change や test failure を潰す

この skill は、build テストの代替ではなく、構造化されたアップグレード支援として扱ってください。出力は、正しいファイルを正しい順序で変更する助けになるべきです。

upgrading-react-native skill の FAQ

通常のプロンプトより優れている？

はい。native code、複数 package、Expo 互換性が絡むアップグレードでは特に有効です。通常のプロンプトでも理論上の手順は出せますが、upgrading-react-native skill のほうが、実際のアップグレード経路を整理し、先に確認すべきファイルやチェック項目を示すのが得意です。

Expo アプリでも使える？

はい。ただし、あくまで広いアップグレード作業の一部として使うのが前提です。アプリ package に expo が含まれる場合は、Expo upgrade layer と併用してください。Expo のバージョン整合や expo install --fix によって、依存関係の計画が変わることがあるためです。

初心者向け？

使えますが、最低限の repo の読み方は必要です。たとえば package.json、ios/、android/ がどこにあるか、build をどう実行するかは把握しておく必要があります。この skill はアップグレード時の曖昧さを減らしますが、platform build とアプリ挙動の確認までは不要にしません。

どんなときは使わないほうがいい？

JavaScript だけのリファクタリングで、React Native のバージョン自体を変えない場合は向いていません。また、repo の文脈なしで一般的な migration の雑談をしたいだけなら相性が悪いです。価値の中心は、バージョンとファイル構成を踏まえたアップグレード支援にあるからです。

upgrading-react-native skill を改善する方法

バージョンと対象範囲を明示する

品質を最も大きく上げるのは、正確な source と target のバージョン、そしてアプリの範囲をはっきり書くことです。たとえば 0.75.4 -> 0.78.2、apps/mobile、Expo SDK 51、npm のように指定します。そうすると、skill は広い助言ではなく、正しい diff、package の整合、検証手順に集中できます。

難しい点は最初に伝える

Custom native modules、workspace 構成、壊れやすい依存関係があると分かっているなら、アップグレード計画を頼む前に先に伝えてください。そうすることで、upgrading-react-native skill は互換性チェックを優先し、あなたの stack に合わない変更を提案しにくくなります。

ファイル単位のアップグレード計画を求める

単なる説明よりも、具体的な順序を求めるプロンプトのほうが結果は良くなります。たとえば、「変更するファイル、実行するコマンド、このアップグレードの作業順を列挙してください」のように依頼します。そうすると、実行しやすく、レビューもしやすい出力になります。

1 回目の後で必ず反復する

最初のアップグレード計画のあとに、何が失敗したかをフィードバックしてください。たとえば diff の衝突、pod install のエラー、Gradle の問題、型エラー、テストの失敗などです。upgrading-react-native の良い出力は反復前提です。2 回目の提案で、どの platform や package が問題を起こしているかを絞り込めます。