关于 sb-explore
sb-explore 是用于在隔离环境中迭代 Storybook 组件的技能,适合开发新组件或重新设计现有组件的团队。它将实验与生产代码隔开,并提供达到条件后交由 sb-ship 晋级的流程。
主要功能
- 01在生产组件目录之外进行迭代
- 02按项目配置选择实验文件位置
- 03可关联 Figma 设计稿
- 04通过四项条件判断是否晋级
- 05保留实验并交接至 sb-ship
适用场景
- 01在生产代码之外尝试新组件
- 02对现有组件方案进行设计迭代
- 03对照 Figma 画面调整实验组件
- 04检查组件是否满足晋级条件
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ strongeron/ storybook-workbench --skill sb-explore安装后在 Claude Code 中输入/sb-explore确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
CONTEXT.mdagents/openai.yamlreferences/figma-to-storybook.mdlabs-workflow.md详细介绍
sb-explore — 沙盒迭代(构建模式:探索)
该组件是新建的或正在重新设计。它位于 src/components/ 之外,因此生产代码无法依赖它。搭建之前,请先加载 references/labs-workflow.md。
如果用户粘贴了 Figma URL,还要加载 references/figma-to-storybook.md。不要加载 composition-patterns.md(那是“比较” → sb-wrappers)。
命名:
Explore是此技能中通用的规范术语(标题、磁盘路径、标签)。references/labs-workflow.md早于此次更名,其中使用了Labs/src/stories/labs/—— 应将其理解为同一工作流(Explore = Labs)。编写时使用Explore;在现有仓库中遇到Labs时,将其视为旧别名。
搭建之前(先自问)
- 是在迭代一个即将发布的组件,还是全新开发? 这决定了发布时采用路径 A 还是路径 B。
- 是否粘贴了 Figma URL? 如果是,立即设置
parameters.design = { type: 'figma', url },然后对照画板进行迭代(参见 figma-to-storybook.md)。 - API 是否足够稳定,可以进入毕业流程? 请参见 labs-workflow.md 中的 4 项标准。如果不满足,就留在 Explore 阶段。
搭建
- 磁盘路径 —— 遵循记录在
storiesLocation(.storybook/audit/status.md)中的配置:当故事文件为隔离存放(审计/客户端默认设置)时,在.storybook/explore/<topic>/下搭建实验——不要散落到你无权管理的src/中。仅当用户为自己拥有的项目选择了同地存放时,才使用src/explore/<topic>/。Vite 会将这两处路径排除在生产包之外。 - 标题 ——
Explore/<topic>/<name>—— 在storySort.order中排最后,显示在侧边栏底部。 - 标签 ——
['explore', '!autodocs', '!test']。可选:'motion'、'figma-sync'、'v2-preview'。
毕业门槛(Explore → Component)
labs-workflow.md 中的 4 项标准:API 稳定 · 计划用于 ≥3 个调用点 · 设计师已审核 · 令牌不是魔法数字。全部满足后 → 触发 sb-ship(它会保留实验,绝不会执行 git mv)。在此之前,继续在这里迭代。
下一步
继续迭代;达到门槛后,移交给 sb-ship。将进展追加到 .storybook/audit/status.md,以便中断的会话能够顺利恢复(CONTEXT.md 恢复协议)。