Agent Skills
返回列表
购物车订单优惠券校验与优惠计算

购物车订单优惠券校验与优惠计算

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-checkout-cart-coupon-check。

技能介绍

要解决什么问题

海外运营平台在提交/结算前,需要知道当前购物车订单绑定的优惠券是否仍有效、能抵扣多少金额。若把这一步和登录、选券、改地址等接口揉在一个大工具里,agent 很难在「只重算优惠」或「校验失败回滚」时做精确编排。本技能对应平台原子动作 cart_coupon_check:用固定正式环境地址对指定订单做一次基础校验与优惠计算,把接口原始响应交给上层,而不是在本地臆造优惠额或订单状态。

技能如何工作

  • 对外只暴露一个动作:cart_coupon_check,HTTP 为 GET,路径为 /coupon-member/cartOrderCouponCheck(完整基址见技能 frontmatter 的 base_url)。
  • 调用参数统一放在嵌套对象 params 里:Query 使用 params.query,其中需包含 orderIds;登录态通过 params.accessToken 生成 Authorization: Bearer(若已带 Bearer 则不重复拼接)。
  • 执行器不得用用户输入覆盖正式环境 base_url;返回以接口响应为准,认证、权限、参数或业务错误应把原始错误码与信息向上传递。

适用边界与注意点

这是最小颗粒度接口 skill,只完成本接口一步。完整「优惠与提交」链路需由上层 agent 按聚合 skill(如 platform-coupon-checkout)或计划文档串联多个原子 skill。若用户需求包含多步操作,本技能只负责校验与计算,不负责后续下单或改券逻辑。

使用场景

  • 结算页展示前,agent 需根据已选 `orderIds` 调用接口重算优惠金额并判断券是否仍可用
  • 用户修改购物车商品数量后,在提交订单前单独触发一次优惠券基础校验,避免沿用过期抵扣结果
  • 编排 `platform-coupon-checkout` 链路时,在选券或改单步骤之后插入本接口,把返回字段交给后续提交 skill
  • 接口返回权限或参数错误时,上层 agent 需拿到原始错误码向运营或客服说明无法完成优惠计算

适合人员

  • 负责酷特海外站结算链路的后端或集成工程师,需要把 `cartOrderCouponCheck` 封装成可编排的原子 skill
  • 写购物车结算 agent 的产品或技术同学,要在「只重算优惠」场景下单独调用 GET 校验而不触发下单
  • 对接 Kutetailor 正式环境的运维或 QA,需在带 `accessToken` 的登录态下验证 `orderIds` 查询参数与返回结构
  • 维护 `platform-coupon-checkout` 聚合文档的架构师,需要明确本 skill 只覆盖 `cart_coupon_check` 一步