用途:为 Storefront Next 垂直方案搭建或同步 Figma 设计套件,使设计套件与代码中的品牌令牌保持一致。它是 sfnext-create-vertical 的设计套件配套技能:先在代码中创建或修改品牌令牌,再运行本技能在 Figma 中镜像。
前提条件:需在 AI 工具的 MCP 配置中连接 Figma MCP 服务器;需带有 node-id 参数的 Figma URL;需对 Figma 文件有编辑权限。未连接 MCP 服务器时应先配置再返回。获取 node-id:在 Figma 中右键任意 frame 或组件 → Copy/Paste as → Copy link。
主要流程:
- 复制官方 Storefront Next Design System 社区套件(https://www.figma.com/community/file/1646023293012114166),在 Figma 中 Duplicate 到草稿,移入团队项目,重命名为 Storefront NEXT — [Vertical Name],记录新 file key。
- 更新变量集合:仅更新 Brand 集合值以匹配 src/theme/tokens/brand.css,不要直接编辑 Semantic/Core 值(它们别名 Brand 值)。映射如 --brand-black → Brand / black,--brand-primary → Brand / primary,--brand-gray-50…950 → Brand / gray-*。所有填充/描边/效果必须绑定变量,禁止原始 hex/RGB;无合适变量时应停止、记录节点与原因、提出名称与值并获批准后再创建。
- 排版:若使用自定义字体,更新 text/body、text/label、text/heading 文本样式,并确保字体通过 Figma Font Service 或上传的自定义字体可用。
- 组件编辑:在正确图层编辑,遵守实例/组件边界,不能向实例追加子节点,应编辑源组件。
- Code Connect:维护 .figma.ts 映射并在变更后发布,命令为 FIGMA_ACCESS_TOKEN=<your-token> npx figma connect publish。
- 发布与维护:发布 Figma 库并通知设计团队接受更新;令牌变更后更新 Brand 变量并重新发布,组件属性/变体变更后更新 .figma.ts 并重新发布 Code Connect。
执行模式:辅助模式(Figma MCP 自动化)在变更前验证目标节点,按逻辑批次应用(令牌→logo→组件),每批后截图,颜色操作保持变量绑定;手动模式将流程作为清单直接在 Figma 中编辑,保留变更日志并从终端运行 Code Connect 发布。
验证:若修改了 .figma.ts 映射或组件代码,在 monorepo 根目录运行 pnpm typecheck、pnpm lint、pnpm test-storybook:snapshot:agent,三者须零错误零警告通过。
限制:依赖 Figma MCP 服务器与编辑权限;API 复制需更高 OAuth 权限,故复制在 Figma 中手动完成;具体收费、价格与平台支持资料未提供。