mcpField
C
creating-b2b-commerce-store

creating-b2b-commerce-store

github.com/forcedotcom开发1.1k3.3k 次安装1 天前更新
代码仓库

关于 creating-b2b-commerce-store

用于在 Salesforce 中创建 B2B Commerce 商店并取回自动生成店面元数据的交互式技能，面向配置商店的团队。它要求先创建 Store，再从实际站点列表选择并检索 Storefront，禁止手动创建店面元数据。

主要功能

  1. 01引导创建 B2B Commerce Store
  2. 02列出可用 Digital Experience 站点
  3. 03确认用户选择的店面站点
  4. 04检索自动生成的店面元数据
  5. 05提供定制与部署后续步骤

适用场景

  1. 01为组织创建 B2B Commerce 商店
  2. 02从现有站点列表选择对应店面
  3. 03将店面元数据取回项目仓库
  4. 04准备定制或部署已检索的店面

安装

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

$npx skills add https://github.com/forcedotcom/sf-skills --skill creating-b2b-commerce-store

安装后在 Claude Code 中输入/creating-b2b-commerce-store确认已加载。

附带文件references/store-vs-storefront.md

详细介绍

Commerce B2B 店面创建

交互式工作流，用于在 Salesforce 中创建 Commerce B2B 商店，并将自动生成的店面元数据检索到你的代码库中。

关键概念

Commerce B2B = 商店（后端数据）+ 店面（前端元数据）。必须先在组织中创建商店，才能自动生成店面。切勿手动创建店面元数据。

请参阅 商店与店面参考

何时使用此技能

在用户请求以下操作时触发： -“创建 B2B Commerce 商店” -“构建 Commerce 店面” -“设置 Commerce B2B” -“创建 B2B Commerce” -“检索 Commerce 店面元数据” -“部署 B2B 店面”

始终适用的规则

  1. 始终遵循交互流程。 不要跳过步骤。每一步都需要用户确认后才能继续。

  2. 切勿手动创建店面元数据。 Commerce 设置向导会生成数百个配置值。手动创建会失败。

  3. 检索前始终列出站点。 商店名称会转换为下划线，并带上数字后缀（例如，“My B2B Store” → “My_B2B_Store1”）。让用户从实际列表中选择。

  4. 始终使用 --json 标志。 所有 Salesforce CLI 命令都要包含 --json，以便输出可解析。

交互式工作流：7 个步骤

第 1 步：说明 Commerce B2B 概念

Agent 说明： Commerce 包含商店（数据）+ 店面（元数据）。必须先创建商店。

请参阅：商店与店面参考

第 2 步：引导用户创建 B2B 商店

Agent 提供以下步骤：

  1. 导航至 Setup → Commerce → Stores

    • 或：App Launcher → Commerce → Create Store

  2. 点击 “Create Store” 或 “Setup New Store”

  3. 将 “Commerce Store” 选为商店类型

  4. 按照向导操作：

    • Store Name：选择描述性名称（例如，“My B2B Store”）
      • 重要：文件夹名称中的空格会变成下划线
    • Site URL：为站点设置唯一的 URL 名称

  5. 完成向导后，它会创建：

    • WebStore 记录
    • 默认买家组和权益策略
    • 关联的 Digital Experience（LWR 站点）

  6. 可选：配置支付网关、税务服务提供商和配送

Agent 随后询问： “你是否已在组织中完成 B2B 商店的创建？准备好后回复‘yes’，并提供你使用的商店名称。”

第 3 步：获取用户确认

Agent 等待： 用户确认和商店名称

Agent 验证： 商店名称格式（不含特殊字符，空格会显示为下划线）

Agent 确认：“太好了！我来列出你组织中可用的店面……”

第 4 步：列出可用的 LWR 站点

Agent 执行：

sf org list metadata --metadata-type DigitalExperienceConfig --json

Agent 应：

  • 解析 JSON 输出以提取站点名称
  • 以编号列表形式显示
  • 说明命名规则（下划线、数字后缀）

输出示例：

Available Digital Experience sites:
1. My_B2B_Store1
2. Partner_Portal
3. Customer_Community
第 5 步：让用户选择店面

Agent 询问： “哪个站点对应你的 B2B 商店？请选择站点名称：”

Agent 验证： 所选站点与可用站点匹配

Agent 确认：“明白了！我会检索 [site-name] 的元数据……”

第 6 步：检索店面元数据

Agent 执行：

sf project retrieve start -m DigitalExperienceBundle:site/<selected-store-name> --json

Agent 应：

  • 显示检索进度
  • 确认检索成功
  • 列出检索到的目录结构

预期输出：

Retrieved: force-app/main/default/digitalExperiences/site/My_B2B_Store1/
├── My_B2B_Store1.digitalExperience-meta.xml
├── sfdc_cms__view/ (home, current_cart, detail_*, list_*, etc.)
├── sfdc_cms__site/
├── sfdc_cms__route/
└── [other sfdc_cms__* directories]
第 7 步：提供后续步骤

Agent 提供：

✅ 元数据已成功检索！

后续步骤：

  • 使用自定义 LWC 或品牌调整进行自定义
  • 部署：sf project deploy start --source-dir force-app/main/default/digitalExperiences/site/My_B2B_Store1/ --json

资源： DigitalExperienceBundle 文档、B2B Commerce 指南

参考

  • store-vs-storefront.md - Store 与 Storefront、源代码管理以及手动创建为何会失败的技术详情

请记住

先创建 Store（会创建 storefront）→ 检索 → 自定义

评论

支持 Markdown