SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场b2c-onboarding

b2c-onboarding

编程与开发

查看项目

更新于 10-16 05:35

技能介绍

用途

b2c-onboarding 是 Salesforce B2C Commerce 开发工具集（b2c-developer-tooling）中的一个入门引导技能，面向初次接触 B2C Commerce、希望从零搭建开发环境的开发者。它的定位是协调者，负责把首次搭建流程串起来，并在每一步把具体工作委派给对应的专项子技能，而不是替代这些子技能。

主要能力

该技能覆盖从 CLI 安装到首次 cartridge 部署的完整上手路径，具体包括：

  • 识别用户所使用的编辑器或客户端（如 Claude Code、Cursor、VS Code、Codex、Gemini CLI 等）。
  • 引导安装其他 B2C 技能插件，例如 b2c-cli 插件，以及可选的 b2c-dx-mcp（MCP 服务器）。
  • 验证 B2C CLI 是否可用。
  • 检查 Account Manager 访问权限。
  • 检查现有配置（dw.json 或凭据）。
  • 初始化配置。
  • 确认或创建沙箱。
  • 完成首次 cartridge 部署。
  • 根据用户目标转交给相应的专项技能。

使用方式

该技能按以下流程推进：

  1. 静默识别编辑器。仅在确实无法判断时才询问用户。
  2. 安装其他 B2C 技能插件。针对不同客户端提供对应安装命令，例如 Claude Code 使用 /plugin marketplace add SalesforceCommerceCloud/b2c-developer-tooling 后再 /plugin install b2c-cli@b2c-developer-tooling；VS Code（GitHub Copilot）通过命令面板的 “Chat: Install Plugin From Source” 输入仓库地址；GitHub Copilot CLI 使用 copilot plugin marketplace add 与 copilot plugin install；Cursor 在设置中添加 marketplace URL 后安装 b2c-cli；Codex 使用 codex plugin marketplace add 与 codex plugin add；Gemini CLI 在终端运行 gemini extensions install。对于不支持 MCP 插件的客户端，可使用文件复制安装器：b2c setup skills，或指定技能集与 IDE，如 b2c setup skills b2c-cli --ide cursor、b2c setup skills b2c --ide vscode；更新已安装技能使用 --update，全局安装使用 --global。
  3. 验证 B2C CLI：运行 b2c --version。若命令不存在，可临时使用 npx @salesforce/b2c-cli <command>，或持久安装 npm install -g @salesforce/b2c-cli（或 pnpm / yarn 等价命令）。
  4. 检查 Account Manager 访问权限。B2C Commerce 没有自助注册，必须由组织的 B2C Commerce 管理员预先开通 Account Manager 访问权限，并提供目标实例（沙箱或 PIG）。若没有，则停止流程。
  5. 检查现有配置：运行 b2c setup inspect。若配置存在且指向可达实例，跳到第 7 步；否则进入第 6 步。深度排障可委派给 b2c-config 技能。
  6. 初始化配置：引导用户在项目根目录创建 dw.json，运行 b2c setup，按提示输入 hostname、client ID/secret（或用户名/密码）以及 code version。更深入的配置主题（多 profile、环境变量、基于证书的认证）委派给 b2c-config 技能。
  7. 沙箱：若使用现有沙箱，用 b2c setup inspect 和 b2c sandbox list 确认可达；若需要新沙箱，委派给 b2c-sandbox 技能，且仅在用户明确要求时才创建。
  8. 首次 cartridge 部署：若本地已有 cartridge，运行 b2c code deploy；选择性部署、watch 模式或 reload 委派给 b2c-code 技能。若还没有 cartridge，可参考 SFRA 仓库（https://github.com/SalesforceCommerceCloud/storefront-reference-architecture）或 PWA Kit / MRT（headless），后者可委派给 b2c-mrt 技能。
  9. 路由到用户目标：询问用户想先做什么，并按回答转交：店面开发转 b2c-controllers、b2c-isml、b2c-forms、b2c-hooks；自定义 API 转 b2c-custom-api-development、b2c-scapi-admin、b2c-scapi-shopper；运维转 b2c-code、b2c-job、b2c-logs、b2c-sites。

行为规则

  • 静默检测编辑器，仅在确实不确定时才询问。
  • 绝不构造或修改安装命令，只使用文件中定义的命令。
  • 任何安装或验证步骤失败时，报告确切错误并停止。
  • 未经用户明确确认，绝不创建沙箱——创建沙箱可能是计费操作。
  • 未经确认，绝不覆盖已有的 dw.json。

适用场景

适用于新开发者首次搭建 B2C Commerce 开发环境、需要安装 CLI 与相关技能插件、需要初始化配置并完成首次部署的场景。也适用于已安装部分技能、想了解如何升级的用户。

限制

B2C Commerce 没有自助注册，必须先由管理员开通 Account Manager 访问权限并提供目标实例，否则流程无法继续。该技能本身不执行具体开发任务，而是负责协调与转交。关于收费、价格、平台支持范围等更多细节，资料中暂未提供。

参考链接

  • B2C CLI 参考：https://salesforcecommercecloud.github.io/b2c-developer-tooling/cli/
  • 安装指南：https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/install
  • Agent skills 概览：https://salesforcecommercecloud.github.io/b2c-developer-tooling/guide/agent-skills