用途:在 Explore 迭代满足毕业门槛时触发,把实验组件转为生产组件,同时保留实验作为设计历史。核心规则是保留实验——用 cp,绝不用 git mv;git mv 是 propagate-workflow.md 要防止的破坏性错误。执行任何 Ship 动作前先加载 references/propagate-workflow.md,这是该技能唯一需要的参考,不要加载 sb-wrappers/sb-audit 的生命周期、画廊、组合等参考。
路径判断:Explore 是否定义了自己的组件文件,还是迭代已有组件,决定 Path A 或 Path B。Path B 再选原地演进(B1)或把 V1 保留在 _legacy/(B2),仅当 V1 仍有活跃调用点需要迁移窗口时用 B2。导入路径是否变化决定是否用 ast-grep 处理调用点。其他带标签的故事是否应翻转(如 Compare 的 decision:pending 改为 decision:chosen 加 winner)。
执行:Path A 新建组件,把组件从 explore cp 到 components,按记录的 storiesLocation(.storybook/audit/status.md,规则见 CONTEXT.md §STORIES LOCATION,不要散落)写新的生产 stories 文件,不要 cp Explore 的 stories(生产关注点不同:autodocs、无决策元数据),验证后仅在路径变化时用 ast-grep 处理调用点。Path B 更新已有组件,把 Explore 的 diff 原地应用到生产组件和 stories,仅在导入路径变化时用 ast-grep。两者都原地闭环(不用 git mv):tags 设为 ['explore','decision:chosen','archived','!autodocs','!test'],并设置 parameters.decision = { status, winner, date, shippedTo },用 find-stories-by-tag.sh decision:chosen 确认。
门槛与后续:对新生产 story 运行捆绑的 scripts/validate-stories.sh(位于 ${CLAUDE_PLUGIN_ROOT}/scripts/validate-stories.sh 或 ${CLAUDE_PLUGIN_ROOT}/scripts/),用 scripts/find-stories-by-tag.sh decision:chosen 确认翻转,把决策追加到 ledger(templates/design-decisions.md),毕业的实验保持原位。重新进入使用流程:毕业组件对 src/ 是新的,尚未进入渲染的 JSON,其 Docs 的 Real usage 带和 storyCoverage 为空,需触发一键使用刷新(refresh-usage.sh,由 sb-audit/sb-inventory 负责),使新组件进入 component-usage.json / project-inventory.json,Storybook 重建后显示真实使用情况,然后 /sb-hub。
限制:资料未提供收费、价格、平台支持范围等信息。