海外运营平台下单页可用优惠券列表

要解决的问题

在 KutSmart 海外运营平台中，运营人员和上层 Agent 需要在下单页展示当前订单可用的优惠券列表。然而，获取这一列表并不是一个简单的前端调用：它需要对接平台正式环境的 /api/coupon/coupon-member/orderCouponMemberList 接口，携带正确的登录态、租户上下文和查询参数（如 couponId、orderType、amount 等），并将返回结果原样传递给后续流程。如果每个业务链路都自行实现这一调用，容易出现参数拼装错误、base_url 被覆盖、认证头重复拼接等问题。

核心能力与关键步骤

order_coupon_list 是一个最小颗粒度的原子 Skill，只负责一件事：调用下单页可用优惠券列表接口。

• 固定环境地址：正式环境地址写死在 frontmatter 的 base_url 中，执行器不会接受用户输入覆盖，避免误调到测试或其他环境。
• 统一参数结构：tool arguments 采用嵌套的 params 对象，而不是 params.xxx 这类点号顶层 key。Path 参数放 params.path，Query 参数放 params.query，JSON Body 放 params.body，额外 Header 放 params.headers。
• 登录态处理：通过 params.accessToken 生成 Authorization: Bearer 头；如果传入值已经包含 Bearer，则不再重复拼接。
• 请求方式：该接口为 GET 请求，查询参数（couponId、orderType、cloth、fabric、orderIds、productId、amount、isSample 等）放在 URL query 中。
• 结果传递：接口返回后，将关键字段交给上层 Agent；若需要完整业务链路，由上层按聚合 Skill platform-coupon-checkout 或计划文档编排多个原子 Skill。

适用边界与注意点

• 该 Skill 只完成当前这一个接口调用，不会自动组合多个接口步骤。
• 返回结果以接口响应为唯一事实来源，不补造库存、价格、订单号、优惠金额或物流状态。
• 该接口属于查询/计算类，但仍受当前登录态、租户和用户权限约束。
• 若接口返回认证、权限、参数或业务错误，原始错误码和错误信息会原样传给上层 Agent，不进行吞错或改写。
• 当上层接口网关对请求体格式另有约定时，以网关契约为准（POST/PUT 默认发送 JSON body）。