SuperAPI AI 工具集

sfnext-overview

编程与开发

查看项目

更新于 11-17 21:24

技能介绍

用途

sfnext-overview 是 Salesforce Commerce Storefront Next(sfnext)开发任务的入口与路由器。它不直接完成某个开发任务,而是帮助判断当前需求应使用哪一个 storefront-next 技能,并给出对应的 CLI 命令和文档检索方式。

使用前须知

技能强调在开始任何工作前先读取项目根目录的 AGENTS.md,它是项目结构、命令和约定的权威来源,技能内容不会覆盖它。同时应查看项目内的 docs/README-.md(每个主题一个文件)和 instructions/.mdc,并优先于记忆中的信息。版本与兼容性参考 docs/COMPATIBILITY.md 和 package.json#storefrontNext。运行环境要求 Node >= 24、pnpm >= 10.28。

任务路由能力

技能以对照表形式把任务映射到具体技能,覆盖的主要方向包括:项目创建与本地运行(sfnext-project-setup)、配置与环境变量(sfnext-configuration)、构建与部署到 Managed Runtime(sfnext-deployment)、路由与 loader/action(sfnext-routing)、数据获取与 SCAPI 调用(sfnext-data-fetching)、重验证与缓存(sfnext-revalidation)、客户端状态管理(sfnext-state-management)、性能优化(sfnext-performance)、登录与 SLAS 认证(sfnext-authentication)、SCAPI 端点与客户端(sfnext-scapi)、混合店面前端代理(sfnext-hybrid-storefronts)、UI 组件(sfnext-components)、主题与设计令牌(sfnext-theming)、Page Designer(sfnext-page-designer)、扩展与 UITargets(sfnext-extensions)、国际化(sfnext-i18n)、测试(sfnext-testing)、安全(sfnext-security)、分析与同意(sfnext-analytics-consent)、SEO(sfnext-seo)、商务功能(sfnext-commerce-features)、质量门禁(sfnext-quality-gates)、上线前站点审计(sfnext-site-audit)以及无障碍(sfnext-accessibility)。Figma 到 Page Designer 的工作属于独立的 figma-to-sfnext-pagedesigner 插件。

附带的命令速查

技能提供 sfnext CLI 速查,该 CLI 随项目安装(@salesforce/storefront-next-dev),建议优先使用 package.json 脚本。涉及命令包括 create-storefront 搭建项目、dev/preview 本地开发与预览、create-bundle/push 构建并推送 bundle、prepare-local 本地构建准备、cartridge 的生成/校验/部署、setup-base-cartridge 注册 SLAS scope、create-instructions 生成扩展安装说明、config 查看与合并扩展配置、extensions 创建与安装、scapi add/available、locales 合并扩展语言文件。具体参数需运行 sfnext <command> --help 并查看项目脚本。

同时提供 b2c CLI 速查(未安装时用 npx @salesforce/b2c-cli),用于店面外围的平台操作:Managed Runtime 项目/环境/变量/bundle/日志(b2c mrt)、cartridge 部署与监听、SCAPI schema 与自定义 API、SLAS 客户端、实例与站点数据、WebDAV、作业、日志以及文档搜索与阅读。

MCP 工具

技能列出 b2c-dx-mcp 的 STOREFRONTNEXT 工具集,包括 mrt_logs_watch、scapi_search、scapi_execute、scapi_snippet_save、scapi_schemas_list、scapi_custom_apis_get_status 以及 docs_search、docs_read、docs_list、docs_schema_search、docs_schema_read、docs_schema_list、validate_xml_schema。可用性取决于 MCP 服务器启动方式,需在客户端中列出工具确认。

文档检索兜底

当项目文档和技能无法解答时,可使用 b2c docs search "storefront next getting started" --category sfnext 搜索 Storefront Next 开发者指南,再用 b2c docs read <id> 阅读结果;MCP 中对应 docs_search 加 docs_read。在项目中工作区检测还会自动提升 Storefront Next 相关结果的排序。

适用场景与限制

适用于在 Storefront Next 项目中开发、排查问题或准备上线时快速找到正确技能和命令。该技能本身是导航性文档,不提供具体实现;具体功能、配置细节和部署步骤需查阅其指向的各个子技能与项目内文档。