SuperAPI AI 工具集

sb-explore

通用与其它

查看项目

更新于 10-16 01:13

技能介绍

用途:sb-explore 属于 Storybook 工作流的沙盒迭代环节(Build 模式的 Explore 轨道)。当组件是全新的或正在重新设计时,把它放在 src/components/ 之外,使生产代码无法依赖它。若用户粘贴了 Figma URL,需要同时加载 references/figma-to-storybook.md;不要加载 composition-patterns.md(那属于 Compare 环节的 sb-wrappers)。

主要能力与命名:Explore 是本技能贯穿标题、磁盘路径和标签的正式术语。references/labs-workflow.md 早于此次改名,其中写的是 Labs 与 src/stories/labs/,应视为同一轨道(Explore = Labs),Labs 仅作为旧仓库中可能遇到的遗留别名。

使用方式:搭建前先自问——是在迭代已发布组件还是全新组件(决定交付时的 Path A 与 Path B);是否粘贴了 Figma URL(若是,立即设置 parameters.design = { type: 'figma', url } 并对照画板迭代);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 个调用点、设计师已评审、使用 token 而非魔法数字。全部满足时触发 sb-ship(保留实验,绝不使用 git mv);否则继续在此迭代。结束前将进度追加到 .storybook/audit/status.md,便于中断的会话依据 CONTEXT.md 恢复协议干净地续接。

限制:资料未提供具体收费、价格、平台与效果信息。