购物车订单优惠券校验与优惠计算
将以下提示词粘贴到你的 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` 一步