mcpField
C
commerce-b2b-store-create

commerce-b2b-store-create

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

关于 commerce-b2b-store-create

指导 Agent 在 Salesforce 中创建 Commerce B2B Store，并检索自动生成的 storefront 元数据。流程要求逐步确认，先创建 Store，再从实际站点列表中选择并检索。

主要功能

  1. 01按交互式七步流程执行
  2. 02要求先在 org 中创建 Store
  3. 03列出站点后供用户选择
  4. 04使用 Salesforce CLI JSON 输出检索元数据

适用场景

  1. 01创建 Commerce B2B Store
  2. 02检索生成的 storefront 元数据
  3. 03选择 org 中对应的数字体验站点
  4. 04准备自定义并部署 storefront

安装

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

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

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

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

详细介绍

Commerce B2B 店面创建

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

核心概念

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

参见 Store vs Storefront Reference

何时使用此技能

用户提出以下请求时触发：

  • “创建 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 包含商店（数据）+ 店面（元数据）。必须先创建商店。

参见：Store vs Storefront Reference

步骤 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 Docs、B2B Commerce Guide

参考

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

请记住

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

评论

支持 Markdown