mcpField
U
upgrading-react-native-storybook

upgrading-react-native-storybook

github.com/storybookjs开发1.3k306 次安装4 天前更新
代码仓库

关于 upgrading-react-native-storybook

用于指导 React Native Storybook 按支持的版本路径逐步升级的技能。它会检查当前配置，每次执行一个迁移步骤，并规定验证与结果汇报方式。

主要功能

  1. 01检测已安装版本和项目配置
  2. 02选择下一项支持的迁移步骤
  3. 03每次仅执行一个版本跃迁
  4. 04处理 6.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 升级

每次只升级一个受支持的版本步进。不要在一次操作中从较旧的大版本直接跳到最新版本。

规则

  • 先检测项目使用的包管理器，并始终使用同一个包管理器。
  • 修改任何内容之前，先从 package.json、锁文件和配置文件中检测当前安装的 Storybook 版本。
  • 每次运行只应用一个迁移步骤。如果项目落后多个版本，先完成下一步并验证，然后报告后续所需的迁移步骤。
  • 在 6.5.x -> 7.6.x 这一步，将所有剩余的 storiesOf 故事转换为 CSF，不要保留兼容模式。
  • 保留项目现有的应用结构。只进行当前步骤所需的迁移更改。

版本检测

综合查看以下线索：

  • package.json 中的 @storybook/react-native、storybook、@storybook/react 和 @storybook/addon-ondevice-* 版本
  • 配置文件夹是 .storybook/ 还是 .rnstorybook/
  • Metro 配置中的导入，例如 metro/withStorybook、metro/withStorybookConfig，或默认导出与命名导出的 withStorybook
  • 故事格式的使用情况：CSF 或 storiesOf
  • 生成文件的名称，例如 storybook.requires.js 或 storybook.requires.ts

如果版本不明确，请停止操作并确认当前安装的版本，不要猜测。

迁移选择

只使用一个参考文件：

  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. 运行仓库中最精简且有用的验证，例如生成脚本、测试、lint，或本地 Storybook 应用的启动流程。
  6. 如果仓库仍未达到用户的目标版本，请停止操作，并清楚说明下一步所需的迁移步骤。

输出要求

完成一个迁移步骤后，请报告：

  • 已完成的版本升级步进
  • 已更改的文件和配置部分
  • 已运行的验证，或无法运行的验证
  • 如果项目仍落后，下一步所需的迁移步进

评论

支持 Markdown