mcpField
S
sb-explore

sb-explore

github.com/strongeron设计与 UI3979 次安装4 周前更新
代码仓库

关于 sb-explore

sb-explore 是用于在隔离环境中迭代 Storybook 组件的技能,适合开发新组件或重新设计现有组件的团队。它将实验与生产代码隔开,并提供达到条件后交由 sb-ship 晋级的流程。

主要功能

  1. 01在生产组件目录之外进行迭代
  2. 02按项目配置选择实验文件位置
  3. 03可关联 Figma 设计稿
  4. 04通过四项条件判断是否晋级
  5. 05保留实验并交接至 sb-ship

适用场景

  1. 01在生产代码之外尝试新组件
  2. 02对现有组件方案进行设计迭代
  3. 03对照 Figma 画面调整实验组件
  4. 04检查组件是否满足晋级条件

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/strongeron/storybook-workbench --skill sb-explore

安装后在 Claude Code 中输入/sb-explore确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

CONTEXT.md
agents/
openai.yaml
references/
figma-to-storybook.md
labs-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 恢复协议)。

评论

支持 Markdown