用途:该技能是 commercetools 与外部系统集成决策的入口,覆盖十三个子领域:支付(Stripe、Adyen、Mollie、PayPal 等)、税务(Avalara、Vertex、TaxJar 等)、CRM(Salesforce、HubSpot、Dynamics 365、Zoho 等)、PIM(Akeneo、inriver、Bluestone、Pimcore 等)、订单管理/OMS(Fluent Commerce、fulfillmenttools、kbrw、OneStock、NewStore、Pipe17)、ERP(SAP S/4HANA 或 ECC、Dynamics 365、Oracle NetSuite、Infor、Odoo、Sage 等)、礼品卡(Voucherify、自建店铺余额等)、事务邮件(SendGrid、Mailgun、AWS SES、Postmark 等)、市场(Marketplacer、Mirakl、Convictional、渠道管理器)、促销/忠诚度(Talon.One、Voucherify、Dovetech、Eagle Eye 等)、分析(BigQuery、Snowflake、Redshift、Databricks、Segment、mParticle)、搜索/商品发现(Algolia、Constructor、Bloomreach、Coveo、Elasticsearch、Typesense)、物流(承运商、比价引擎、面单/履约平台)。
主要能力:每个子领域按同一决策阶梯推进——先判断 commercetools 原生能力是否已够用(促销、搜索、物流有原生能力;ERP 需判断数据是否要复制进 commercetools 还是实时读取),再依次考虑使用公开连接器、仅靠配置补齐、定制/分叉开源连接器、从最接近的应用模板新建。每个子领域包含 overview.md 与 connector-selection.md,其余文件按领域需要命名,如 config-from-requirements.md、*-contract.md、verification.md,部分领域另有 data-mapping.md、build-connector.md、sync-architecture.md、pipeline-architecture.md 等。
使用方式:先路由到对应子领域的 overview.md,不要直接依据本文件回答集成问题。设计前需运行脚本获取最新文档:node "<this skill's directory>/scripts/docs-search.mjs" --query "<terms from the user's request>" --app-name "<host app>" --model "<current-model>" --commercetools-project-key "<if known>" --commercetools-region "<if known>" --limit 10。项目 key 与区域仅在上下文中已有时传入,否则省略。可用 scripts/openApi-schemata.mjs 与 scripts/graphql-schemata.mjs 确认请求/响应结构。
限制:本技能只负责“为某供应商决定构建什么”,不负责构建本身;服务/事件/任务应用的写法、connect.yaml 契约、最小权限 scope、生命周期脚本、同步与异步幂等及 ack 语义、测试、部署与生产就绪门槛属于 commercetools-connect。托管 Checkout 组件、与界面无关的商务领域逻辑(定价、折扣叠加、税务模式、原生物流建模)、SDK 客户端设置与核心数据模型分别属于 commercetools-checkout、commercetools-commerce-patterns、commercetools-platform。连接器可用性需实时查询注册表,供应商字段名、认证、载荷、限制与沙箱行为须查阅其当前 API 文档,不得凭记忆填写。需求、数据流向、事实来源及外部系统不可用时的行为需向用户确认并记录。