SuperAPI AI 工具集

sfnext-create-vertical

通用与其它

查看项目

更新于 10-16 05:44

技能介绍

用途:在 Storefront Next 共享模板之上创建新的垂直主题(品牌主题或店铺变体,如美妆、家具、杂货),不分支共享代码。核心原则是垂直主题几乎完全由设计令牌构成,禁止在组件或 CSS 中使用原始十六进制、RGB 或硬编码颜色,应使用映射到 CSS 变量的语义化 Tailwind 工具类。只有 src/theme/tokens/brand.css 在不同垂直主题间变化,其余为共享基础设施。

主要能力与流程:先阅读 brand.css、core.css、tailwind.css 三个令牌层文件,再确定品牌调色板(品牌名、明暗前景背景、强调色、页头表面、Logo 与字体),仅更新 brand.css 的值而不重命名变量,并做 WCAG AA 对比度检查(正文 4.5:1)。可添加可选字体覆盖与 i18n 内容。使用 fixtures 在未接入真实 SCAPI 凭证时保持本地开发稳定,如创建 src/config/<vertical>-fixtures.ts 并短路 _app.tsx 与 _app.product.$productId.tsx 的 loader。编码前做组件扩展审计,决定是仅改令牌、单垂直扩展(src/extensions/<vertical>/ 经 UITarget 注入)还是给基础组件加插槽。最后用 pnpm dev 验证首页与 PDP 的明暗模式、检查无硬编码颜色类、跑 Storybook 快照,并在代码稳定后同步 Figma kit(先令牌、再 Logo、再共享组件覆盖、再页面框架)。

使用方式:按阶段顺序执行,可采用辅助(IDE 自动化)或手动(清单加决策表)模式。从 monorepo 根目录运行 pnpm typecheck、pnpm lint、pnpm test-storybook:snapshot:agent,三者须零错误零警告。

适用场景:创建品牌主题或店铺变体,需要在不 fork 共享代码的前提下定制视觉与内容。

限制:不得在 src/components/ui/ 下 fork 原语,不得编辑 core.css、header.css 等核心样式,不得给共享组件加 if (vertical) 分支。价格、收费、平台信息暂未提供。