关于 commercetools-api
面向 commercetools API 开发的技能，按主题提供渐进式参考指南，涵盖 SDK、购物车、订单及客户管理等。它强调版本控制、结账和折扣等关键实现模式，并可配合 Developer MCP 与 Commerce MCP 使用。
主要功能
- 01按需加载主题参考文件
- 02指导 SDK 客户端设置
- 03涵盖购物车与结账流程
- 04说明订单和客户管理
- 05提示常见反模式与风险
适用场景
- 01开始设置 commercetools SDK
- 02实现购物车、支付或订单流程
- 03构建客户与 B2B 功能
- 04审查 API 代码并排查问题
MCP 相关
该技能用于指导 commercetools API 的实现模式；README 建议结合 Developer MCP 查询字段和架构，并使用 Commerce MCP 执行 CRUD 操作。
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/commercetools-api确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
references/anti-patterns.mdb2b-patterns.mdcart-checkout.mdcustomer-management.mdextensions-subscriptions.mdorder-management.mdperformance.mdpromotions-pricing.mdsdk-setup.mdsearch-discovery.md详细介绍
commercetools API 开发
渐进式加载——只加载所需内容：
- 设置 SDK 或客户端？加载
references/sdk-setup.md - 构建购物车或结账流程？加载
references/cart-checkout.md - 处理订单？加载
references/order-management.md - 管理客户？加载
references/customer-management.md - 设置扩展或订阅？加载
references/extensions-subscriptions.md - 实现折扣？加载
references/promotions-pricing.md - 构建 B2B 功能？加载
references/b2b-patterns.md - 实现搜索？加载
references/search-discovery.md - 优化性能？加载
references/performance.md - 代码审查或调试？加载
references/anti-patterns.md
编写 commercetools API 代码前，必须加载相关参考文件。 设置 SDK 客户端时，始终从 references/sdk-setup.md 开始。
关键优先级
| 模式 | 文件 | 影响 |
|---|---|---|
| 乐观并发与版本处理 | references/sdk-setup.md | 如果未正确跟踪版本，每次更新/删除都会失败 |
| 购物车生命周期与付款前冻结 | references/cart-checkout.md | 结账期间价格变动会导致订单失败 |
| 付款流程——绝不重复使用/删除 Payments | references/cart-checkout.md | 审计记录丢失、重复扣款、PSP 不一致 |
| 扩展超时限制（2s / 10s） | references/extensions-subscriptions.md | 超时会导致整个 API 调用失败，影响所有客户端 |
| 折扣叠加与排序 | references/promotions-pricing.md | 定价异常、收入损失、客户投诉 |
| 直接折扣会阻止折扣代码使用 | references/promotions-pricing.md | 存在直接折扣时，折扣代码会悄然失效 |
高优先级
| 模式 | 文件 | 影响 |
|---|---|---|
| 客户端设置与身份验证流程 | references/sdk-setup.md | 设置错误会导致身份验证失败和令牌泄漏 |
| 订单状态机与退货 | references/order-management.md | 状态转换无效、履约不完整 |
| 客户身份验证与电子邮件验证 | references/customer-management.md | 注册/登录失效、账户未验证 |
| 订阅幂等性与顺序 | references/extensions-subscriptions.md | 副作用重复、旧数据覆盖新数据 |
| 业务单元层级与权限 | references/b2b-patterns.md | 安全漏洞、审批工作流失效 |
| Product Search API 与 Query API | references/search-discovery.md | 大型目录中的查询速度慢 10–100 倍 |
| N+1 查询与引用展开 | references/performance.md | 列表页面延迟逐级增加 |
中优先级
| 模式 | 文件 | 影响 |
|---|---|---|
| 税务模式配置 | references/cart-checkout.md | 税务数据不完整导致订单创建失败 |
| 审批规则与报价生命周期 | references/b2b-patterns.md | B2B 采购工作流受阻 |
| Connect 应用模式 | references/extensions-subscriptions.md | 部署失败、资源限制问题 |
| 分页与查询优化 | references/performance.md | 页面加载缓慢、不必要的 API 负载 |
| 客户组与地址管理 | references/customer-management.md | 定价层级错误、地址数据问题 |
| 分面与搜索性能 | references/search-discovery.md | 搜索响应缓慢、相关性较差 |
常见反模式（速查）
| 反模式 | 文件 | 后果 |
|---|---|---|
| 每次请求都创建一个客户端 | references/anti-patterns.md | 内存泄漏、令牌耗尽 |
| 不批量处理更新操作 | references/anti-patterns.md | 高负载下发生版本冲突 |
| 使用 /products 而非 /product-projections | references/anti-patterns.md | 响应负载大小增加一倍 |
| 轮询而非使用 Subscriptions | references/anti-patterns.md | 浪费 API 配额、检测延迟 |
| 忽略 ConcurrentModification 错误 | references/anti-patterns.md | 数据悄然丢失、状态损坏 |
| “以防万一”展开所有引用 | references/anti-patterns.md | 响应臃肿、查询缓慢 |
| 为每位访客创建空购物车 | references/anti-patterns.md | 产生数百万个未使用的购物车资源 |
| 不监控 Subscription 健康状况 | references/anti-patterns.md | 通知悄然失效长达 7 天 |
MCP 补充
使用此技能了解正确的模式，然后使用 Developer MCP 查找确切的字段名称和架构，并使用 Commerce MCP 执行 CRUD 操作。
评论
支持 Markdown