购物车订单优惠券校验与优惠计算
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-coupon-checkout-cart-coupon-check。
技能介绍
要解决什么问题
在酷特海外运营(KuteTailor)结账链路里,用户选中优惠券后,需要先确认这些券能否用于当前购物车订单,并拿到可计算的优惠结果,再进入提交或支付。若把整段优惠与提交流程塞进一个巨型工具,Agent 难以按步骤重试、组合和排错。
本技能是最小颗粒度的原子接口技能,只负责 cart_coupon_check:对指定订单发起购物车订单优惠券基础校验与优惠计算。
技能如何工作
- 固定正式环境:请求走 frontmatter 中的
base_url(GET …/coupon-member/cartOrderCouponCheck),调用方不得用用户输入覆盖域名。 - 统一参数形态:tool 参数最外层仅包含嵌套对象
params;Query 写入params.query(如orderIds),登录态用params.accessToken生成Authorization: Bearer(已带Bearer前缀则不重复拼接)。 - 事实来源:返回以接口响应为准,不补造优惠金额、订单号或库存;认证、权限、参数或业务错误时,把原始错误码与信息交给上层 Agent 编排。
适用边界与注意点
- 仅覆盖单接口动作;若需求包含领券、改购物车、下单等多步,应由上层按聚合 skill
platform-coupon-checkout或计划文档串联多个原子 skill。 - 本接口为查询/计算类,仍受当前登录态、租户与用户权限约束;
orderIds等 Query 需与平台契约一致。
使用场景
- 结账前 Agent 已拿到购物车订单 ID 列表,需调用 cartOrderCouponCheck 校验所选券是否可用并返回优惠计算结果
- 海外运营客服脚本在改单场景中,需对指定 orderIds 重新跑一遍优惠券基础校验,避免口头承诺与系统不一致
- 编排 platform-coupon-checkout 链路时,在展示应付金额前单独插入本接口,把 RS 中的优惠字段交给后续提交 skill
- 联调 KuteTailor 正式环境时,用固定 base_url 与 Bearer 登录态验证 orderIds 参数与错误码回传是否符合网关契约
适合人员
- 负责酷特海外电商结账 Agent 编排的后端工程师,需要把优惠计算拆成可单独重试的原子步骤
- 维护 platform-coupon-checkout 聚合 skill 的平台集成同学,要在文档里对齐 cart_coupon_check 的入参与 RS 字段
- 海外运营侧做优惠规则验收的测试工程师,需用真实 orderIds 对照接口返回的优惠金额与错误信息
- 为客服或运营 Copilot 写工具链的开发者,只需完成「校验+算价」一步而不接管整单提交