Kutesmart 优惠券报表

要解决什么问题

优惠券报表是 Kutesmart 海外运营平台的日常运营动作之一，但上层 agent 拿到的往往是一个跨多个接口的业务流程。如果把「查优惠券报表」这样的原子动作塞进一个大而全的 skill，后续任何接口变更都会牵一发动全身。这个 skill 的定位是最小颗粒度接口 skill：它只负责一件事，就是把 coupon_report 这个接口调用做正确，返回什么就是什么。

技能如何工作

核心能力

• 固定调用正式环境地址 GET https://www.kutetailor.com/api/coupon/coupon-member/reportCoupon，生成优惠券报表
• 接收两个查询参数：day（日期）和 userId（用户 ID）
• 返回结构为 RS>，内容以接口响应为准

调用约定

tool arguments 统一使用嵌套的 params 对象，最外层只放 params，不要使用 params.xxx 这类点号顶层 key。参数落位规则如下：

• params.query：放置 URL query 参数，如 day、userId
• params.path：放置 URL path 中的变量
• params.body：放置 JSON body（POST/PUT 默认发送 JSON body）
• params.headers：放置额外请求头
• params.accessToken：生成 Authorization: Bearer 登录态

执行要点

执行器必须使用 frontmatter 中的固定正式环境地址，不接受用户输入覆盖 base_url。当用户需求包含多个接口步骤时，本 skill 只完成本接口调用，把关键返回字段交给后续 skill，由上层 agent 按聚合 skill 或计划文档编排多个原子 skill。

适用边界与注意点

• 本 skill 是查询/计算类接口，仍需遵守当前登录态、租户和用户权限。认证、权限、参数或业务错误会原样抛出，上层 agent 需要据此处理。
• 返回结果必须以接口响应为事实来源，不要补造优惠金额、订单号、库存等字段。
• 如果传入的 accessToken 已含 Bearer，不要重复拼接。
• 若上层接口网关另有约定（如非 JSON body），以网关契约为准。