关于 b2c-sites
b2c-sites 是一项 Agent Skill，指导使用 `b2c` 命令行查看 Salesforce B2C Commerce 站点并管理 cartridge 路径。它支持配置来源检查和便于脚本处理的 JSON 输出。
主要功能
- 01列出站点及店面状态
- 02以 JSON 查看站点元数据
- 03查看和编辑 cartridge 路径
- 04发现命令行配置来源
- 05必要时回退到归档导入
适用场景
- 01为其他命令查找站点 ID
- 02检查店面是否在线
- 03在自动化流程中提取站点元数据
MCP 相关
这是指导使用 `b2c` 命令行的 Agent Skill；输入未说明其与 MCP 服务连接或管理的关系。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/b2c-sites确认已加载。
附带文件evals/trigger-evals.json
详细介绍
B2C Sites 技能
使用 b2c CLI 插件列出和管理 Salesforce B2C Commerce 实例上的店铺站点。
提示： 如果未全局安装
b2c，请改用npx @salesforce/b2c-cli（例如，npx @salesforce/b2c-cli sites list）。
配置与身份验证
CLI 会从 SFCC_* 环境变量（包括项目 .env）、所选的项目本地或共享 dw.json 以及配置插件中自动发现目标实例和凭据。package.json 仅提供非敏感默认值。通常无需传入 --server、--client-id 和 --client-secret 等标志——只有在要覆盖自动检测到的值时才传入。
运行 b2c setup inspect，查看解析后的配置以及每个值的来源（用于脚本编写时可使用 --json；默认情况下，机密信息会保持隐藏）。有关优先级规则和故障排查，请参阅 b2c-cli:b2c-config 技能。
命令
b2c sites list
列出 B2C Commerce 实例上的所有站点，并显示站点 ID、显示名称和店铺状态。
# list all sites on the configured instance
b2c sites list
# list sites on a specific server
b2c sites list --server my-sandbox.demandware.net
# list sites with JSON output (useful for parsing/automation)
b2c sites list --json
# use a specific instance from config
b2c sites list --instance production
# enable debug logging
b2c sites list --debug
Cartridge 路径管理
管理站点上已启用 cartridge 的有序列表。也可使用单数别名 sites cartridge。
# list the cartridge path for a storefront site
b2c sites cartridges list --site-id RefArch
# list the Business Manager cartridge path
b2c sites cartridges list --bm
# add a cartridge to the beginning of a site's path (default)
b2c sites cartridges add plugin_applepay --site-id RefArch
# add a cartridge to the end
b2c sites cartridges add plugin_applepay --site-id RefArch --position last
# add a cartridge after a specific cartridge
b2c sites cartridges add plugin_applepay --site-id RefArch --position after --target app_storefront_base
# add a cartridge to Business Manager
b2c sites cartridges add bm_extension --bm --position first
# remove a cartridge from a site
b2c sites cartridges remove old_cartridge --site-id RefArch
# replace the entire cartridge path
b2c sites cartridges set "app_storefront_base:plugin_applepay:plugin_wishlists" --site-id RefArch
# JSON output for automation
b2c sites cartridges list --site-id RefArch --json
如果无法使用 /sites/*/cartridges 的 OCAPI 直接权限，cartridge 命令会自动回退到站点归档导入/导出。Business Manager（--bm）更新始终使用站点归档导入。
关键标志（继承自 InstanceCommand）：
| 标志 | 短标志 | 说明 |
|---|---|---|
--server | -s | B2C 实例主机名（环境变量：SFCC_SERVER） |
--json | 以 JSON 格式输出完整站点数据 | |
--instance | 配置中的命名实例 | |
--debug | 启用调试日志 |
输出列： ID、显示名称、状态（storefront_status）。
JSON 输出会返回完整的站点对象，包括所有属性（适用于提取表格中未显示的渠道 ID、自定义首选项及其他站点元数据）。
如果配置了 shortCode、tenantId 和 sfcc.sites / sfcc.sites.rw 范围，站点读取和 cartridge 路径写入会通过 SCAPI（site/sites API）执行。auto 在安全的 SCAPI 请求被拒绝时会临时回退到已弃用的 OCAPI；如果无法使用直接 API，写入还可以进一步回退到站点归档导入。
常见用例
查找其他命令所需的站点 ID： 许多命令（例如，站点导入/导出）都需要站点 ID。使用 sites list 查找有效 ID：
b2c sites list
# then use the ID in other commands
b2c job export --site RefArch --site-data content,site_preferences
检查站点状态： 状态列显示每个站点的店铺状态（在线/离线），便于验证部署状态。
脚本编写和自动化： 使用 --json 获取机器可读的输出，以便用于 CI/CD 流水线：
b2c sites list --json | jq '.data[].id'
相关技能
- b2c-config——配置实例和凭据，并排查连接问题
- b2c-site-import-export——导入/导出站点归档和元数据 XML