用途:在尚无 Storybook 的 React+Vite 应用中完成安装与配置对齐。它本身是薄对齐+校验层,不重新实现引导向导,初始化交给 Storybook 官方流程。
主要能力:先检测是否已有 Storybook(test -d .storybook && grep -q '"storybook"' package.json),没有则让用户运行 npm create storybook@latest,并执行 npx storybook skills setup(10.6+;10.4–10.5 为 npx storybook ai setup)。随后补齐官方流程未详述的部分:用 discover-runtime.py 生成 .storybook/runtime.json 作为事实来源;调整 viteFinal;按 runtime.json.providers 添加 provider 装饰器;为类式暗色主题在 preview-head.html 中设置画布根样式;为裸 OKLCH/shadcn 通道 token 生成 --color-* 桥接;检测并接入 @storybook/addon-mcp 与 .mcp.json;写入 manager.ts 使 Controls/Actions/Accessibility 面板默认可见;用 @storybook/addon-themes 的 withThemeByClassName 实现主题切换;确认已内置的 @storybook/addon-a11y;在 preview.tsx 中配置 docs.page 组合;沿用既有 storySort 与目录结构。
使用方式:先运行官方初始化命令,再加载 references/install-wizard.md 执行对齐;故事存放位置必须询问用户,可选 .storybook/stories/(默认)、与组件同目录或自定义文件夹,并记录到 .storybook/audit/status.md。
适用场景:为审计、客户或杂乱仓库引入 Storybook,并希望配置一致、可验证。
限制:不替代官方引导;不自行发起网络请求;命令名随 Storybook 小版本变化;.storybook/ 下新增故事文件不会热重载,需重启;未提供具体收费、平台或效果信息。