mcpField
U
upgrading-react-native-storybook

upgrading-react-native-storybook

github.com/storybookjs開発1.3k306 回インストール4 日前に更新
リポジトリ

upgrading-react-native-storybook について

React Native Storybookを対応するバージョン経路に沿って段階的に更新するスキルです。現在の構成を調べ、1回に1つの移行を適用し、検証と報告の手順を定めます。

主な機能

  1. 01インストール済みバージョンと構成の検出
  2. 02次に対応する移行手順の選択
  3. 031回につき1つのバージョン移行
  4. 046.5から7.6へのstoriesOf変換
  5. 05検証と完了報告の手順

活用シーン

  1. 01複数バージョン遅れたStorybookプロジェクトの更新
  2. 02リポジトリのファイルから移行経路を特定
  3. 03次の移行前に変更を検証

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/storybookjs/react-native --skill upgrading-react-native-storybook

インストール後、Claude Code で/upgrading-react-native-storybookを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
from-5-3-to-6-5.md
from-6-5-to-7-6.md
from-7-6-to-8-3.md
from-8-to-9.md
from-9-to-10.md
storiesof-to-csf-examples.md

詳細

React Native Storybook のアップグレード

サポート対象のバージョンを、1 ステップずつアップグレードしてください。古いメジャーバージョンから最新リリースへ、一度の作業で直接アップグレードしないでください。

ルール

  • まずプロジェクトのパッケージマネージャーを検出し、以降は一貫して使用してください。
  • 編集を始める前に、package.json、ロックファイル、設定ファイルから現在インストールされている Storybook のバージョンを検出してください。
  • 実行ごとに適用するマイグレーションは、必ず 1 ステップだけにしてください。複数バージョン遅れている場合は、次の段階までアップグレードして検証し、その後、次に必要な段階を報告してください。
  • 6.5.x -> 7.6.x の段階では、互換モードを維持するのではなく、残っている storiesOf のストーリーを CSF に変換してください。
  • プロジェクトの既存のアプリ構成を維持してください。現在の段階で必要なマイグレーション変更のみ行ってください。

バージョンの検出

以下の情報を組み合わせて確認してください。

  • @storybook/react-native、storybook、@storybook/react、@storybook/addon-ondevice-* の package.json 上のバージョン
  • 設定フォルダーが .storybook/ か .rnstorybook/ か
  • metro/withStorybook、metro/withStorybookConfig のインポートや、withStorybook のデフォルトエクスポートか名前付きエクスポートかなど、Metro の設定
  • ストーリーフォーマットの使用状況：CSF か storiesOf か
  • storybook.requires.js と storybook.requires.ts などの生成ファイル名

バージョンを特定できない場合は、推測せずに作業を中止し、現在インストールされているバージョンを確認してください。

マイグレーションの選択

参照ファイルは、必ず次のうち 1 つだけ使用してください。

  1. 9.x -> 10.x：references/from-9-to-10.md
  2. 8.x -> 9.x：references/from-8-to-9.md
  3. 7.6.x -> 8.3.x：references/from-7-6-to-8-3.md
  4. 6.5.x -> 7.6.x：references/from-6-5-to-7-6.md
  5. 5.3.x -> 6.5.x：references/from-5-3-to-6-5.md

ワークフロー

  1. 現在の Storybook のバージョンと、リポジトリで Expo、Expo Router、React Native CLI、Re.Pack のどれを使用しているかを確認します。
  2. 次のマイグレーション段階だけを選びます。複数のメジャーアップグレードをまとめて行わないでください。
  3. 該当する参照ファイルに記載された依存関係、設定、ソースファイルの変更を適用します。
  4. その段階で必要な場合は、storybook.requires を再生成するか、Metro を再起動します。
  5. リポジトリで利用できる、生成スクリプト、テスト、リンター、ローカル Storybook アプリの起動など、最小限で有用な検証を実行します。
  6. リポジトリがユーザーの目標バージョンにまだ達していない場合は、次に必要なマイグレーション段階を明記して作業を中止します。

出力時の要件

マイグレーション段階を完了したら、次の内容を報告してください。

  • 完了したバージョン間の移行
  • 変更したファイルと設定箇所
  • 実施した検証、または実施できなかった内容
  • プロジェクトがまだ目標バージョンに達していない場合は、次に必要なマイグレーション

コメント

Markdown 対応