技能介绍

这个 skill 解决什么问题

海外运营平台里有一批会员优惠券存放在优惠券钱包中，运营同学需要判断某张券到底是 NORMAL 还是 MTO 类型，才能走后续的核销、审核或统计流程。这类判断如果靠人肉翻后台，既慢又容易出错；如果让大模型直接猜，又会凭空捏造券类型，污染业务数据。

coupon_category 这个动作把这件事收敛成一个最小颗粒度的接口调用：给定会员 ID，返回权威的券类型结论，把「猜」从链路里彻底移除。

技能如何工作

核心能力

固定发起 GET https://www.kutetailor.com/api/coupon/coupon/category/{couponMemberId}
Path 参数从 params.path 注入，{couponMemberId} 占位符只接受 couponMemberId 一个变量
返回的券类型结论（NORMAL / MTO）作为后续 skill 的输入，而不是让上层模型自由发挥

调用约定

调用时统一把参数收进嵌套的 params 对象，最外层不要出现 params.xxx 这类带点号的顶层 key。分类规则很明确：

Path 参数写入 params.path
Query 参数写入 params.query
JSON Body 写入 params.body
额外 Header 写入 params.headers

鉴权方面，正式环境地址写死在 frontmatter 的 base_url 里，执行器不会接受用户输入去覆盖它。登录态由上层传入 params.accessToken，执行器据此生成 Authorization: Bearer；如果传入的值本身已经带了 Bearer 前缀，就不会重复拼接。

执行流程

从上层 agent 拿到目标会员 ID
组装 params.path.couponMemberId 与登录态参数
向固定正式环境地址发起 GET 请求
原样把接口返回传给上层

适用边界与注意点

这不是一个完整业务链路。 它只负责 coupon_category 这一个动作，查询到券类型之后，后续步骤需要由上层 agent 按聚合 skill 或计划文档编排其他原子 skill 来完成。
本 skill 是查询类接口，但仍会校验当前登录态、租户与用户权限。权限不足时会拿到错误码，而不是静默成功。
返回值是接口响应的原文，不做补造。 接口没有返回库存、价格、订单号、优惠金额或物流状态，skill 也不会编造这些字段。
遇到认证、权限、参数或业务错误时，会把原始错误码和错误信息原样透传给上层 agent，便于定位是调用方参数问题还是平台侧问题。
如果上层接口网关对 POST/PUT 的 body 格式另有约定，以网关契约为准，本 skill 默认提交 JSON body。