upgrading-react-native
作者 callstackincubatorupgrading-react-native 可協助規劃並執行 React Native 版本升級，包含使用 rn-diff-purge 或 Upgrade Helper diff、依賴套件對齊、iOS 與 Android 設定更新，以及建置驗證。它特別適合正在升級實際應用程式的前端開發團隊，包括 monorepo 與以 Expo 為基礎的專案。
這個技能的評分是 86/100，代表它很適合作為需要有引導式 React Native 升級流程的目錄使用者之優先推薦項目。這個儲存庫提供了足夠具體的結構、導引與逐步參考，讓代理在觸發時比通用提示少很多猜測；不過，遇到特殊情況與驗證時，使用者仍需要配合連結的補充參考一起操作。
- 對 React Native 升級有明確的觸發條件與適用範圍，包括版本升級、RN 0.x 到 0.y 的遷移，以及接近 Expo SDK 的升級情境。
- 作業流程清楚，典型升級順序涵蓋路由、Upgrade Helper diff、依賴更新、React 配對、Expo 步驟與驗證。
- 透過多個聚焦的參考檔案提供良好的代理操作槓桿，把升級拆成可執行的子技能，降低歧義。
- SKILL.md 裡沒有安裝指令，因此採用方式取決於目錄的外部安裝流程，而不是儲存庫內的一鍵設定。
- 主檔案偏向路由／總覽，因此要成功使用，仍需沿著連結的參考文件查找詳細指令與例外處理。
upgrading-react-native 技能概覽
這個技能能做什麼
upgrading-react-native 技能能幫你規劃並執行 React Native 版本升級，少掉比一般提示詞更多的猜測。它聚焦在真正的升級工作：選對升級路徑、套用 rn-diff-purge / Upgrade Helper 的差異、對齊相依套件，以及處理常見會讓 iOS 和 Android 建置失敗的變更。
適合誰使用
如果你在 React Native app 中做 Frontend Development，並且需要從一個 RN 版本升到另一個版本，尤其是牽涉到原生資料夾、CocoaPods、Gradle，或 Expo SDK 相容性時，就適合用 upgrading-react-native 技能。它最適合需要可重複升級流程的維護者，而不是只想要一次性「把版本升上去」答案的人。
它的實用價值在哪裡
它最大的價值是流程指引：幫你安排升級順序、把 app 範圍內的變更和相依套件調整分開，並且提早抓出常見的失敗點。當你的目標是升級一個已有真實原生程式碼的既有 app，而不只是改 package.json 時，它的效果最好。
如何使用 upgrading-react-native 技能
安裝並觸發
使用 upgrading-react-native install 流程搭配 agent skill 指令：
npx skills add callstackincubator/agent-skills --skill upgrading-react-native
接著用提示詞叫用它，並包含你目前與目標版本、app 結構，以及任何特殊限制。例如：「使用 upgrading-react-native 技能，將我們 monorepo 裡的 app 從 RN 0.76.9 升級到 0.78.2。app 位於 apps/mobile，使用 Expo，且 iOS 與 Android 建置都必須保持綠燈。」
提供正確的輸入
這個技能在你提供以下資訊時效果最好：
- 目前的 React Native 版本與目標版本
- 這是 Expo 還是 bare RN
- repo 結構：單一 app 或 monorepo
- 套件管理工具與原生建置設定
- 已知阻礙，例如自訂原生模組、CodePush，或嚴格的 CI 規則
如果你只說「升級 RN」，輸出就會太泛。若你把版本、app 路徑與限制都交代清楚，這個技能就能更準確地對應差異檔與相依套件決策。
先閱讀這些檔案
在使用 upgrading-react-native 時，請先看：
SKILL.md：升級順序references/upgrade-helper-core.md：以 diff 為核心的流程references/monorepo-singlerepo-targeting.md：app 不在 repo 根目錄時要看references/upgrading-dependencies.md：套件相容性檢查references/expo-sdk-upgrade.md：如果有使用 Exporeferences/upgrade-verification.md：升級後驗證
這個閱讀順序很重要，因為它能避免常見失誤：在目標 app 與相依套件範圍還不清楚時，就先套升級差異。
實際工作流程
一份好的 upgrading-react-native 指南，通常會依照這個模式：
- 找出 app 套件與精確的 RN 版本
- 取得相關 template diff
- 更新套件相依性與 companion packages
- 套用原生 iOS 與 Android 設定變更
- 執行建置與驗證檢查
- 第一次跑完後再處理破壞性 API 或測試失敗
把這個技能當成有結構的升級助手，而不是 build testing 的替代品。它的輸出應該幫你按正確順序改對檔案。
upgrading-react-native 技能 FAQ
這比一般提示詞更好嗎？
如果升級牽涉到原生程式碼、多個套件，或 Expo 相容性，答案是肯定的。一般提示詞可以理論上告訴你怎麼做；upgrading-react-native 技能更擅長把實際升級路徑整理好，並指出你應該先檢查哪些檔案與驗證項目。
它適用於 Expo app 嗎？
可以，但只適合作為更大的升級流程的一部分。如果你的 app 套件裡有 expo，就應該和 Expo 升級層一起使用，因為 Expo 版本對齊與 expo install --fix 可能會改變相依套件計畫。
對初學者友善嗎？
初學者也能用，但你仍需要基本的 repo 讀法：知道 package.json、ios/、android/ 在哪裡，以及如何執行建置。這個技能能降低升級的不確定性，但不會免除你驗證各平台建置與 app 行為的責任。
什麼情況下不該用它？
如果只是純 JavaScript 重構，或你其實沒有在更動 React Native 版本，就不適合依賴它。若你想要的是沒有 repo context 的泛用 migration 對話，它也不是好選擇，因為它的價值來自版本感知、檔案感知的升級指引。
如何改進 upgrading-react-native 技能
提供有版本與範圍的輸入
提升品質最大的一步，就是明確寫出來源版本、目標版本與 app 範圍。例如：0.75.4 -> 0.78.2、apps/mobile、Expo SDK 51、npm。這樣技能才能把焦點放在正確的 diff、套件對齊與驗證步驟，而不是給你過於寬泛的建議。
一開始就把困難點講清楚
如果你知道 app 有自訂原生模組、workspace 結構，或容易出問題的相依套件，請在要求升級計畫前先說明。這能讓 upgrading-react-native 技能優先檢查相容性，避免推薦不適合你 stack 的改動。
要求逐檔案的升級計畫
如果你要的是具體可執行的內容，而不是解釋，結果通常會更好。例如：「列出要修改的檔案、要執行的指令，以及這次升級的操作順序。」這樣產出的內容更能直接拿來執行與審查。
第一輪之後持續迭代
拿到第一版升級計畫後，回饋實際失敗的地方：diff 衝突、pod install 錯誤、Gradle 問題、型別錯誤，或測試中斷。最好的 upgrading-react-native 指南是可迭代的；第二輪才是把修正範圍縮到真正出問題的平台或套件。