技能介绍

解决什么

海外运营平台做面料券查询时，接口规则容易被写进大流程里：域名、鉴权、Path/Query 拼装、错误透传混在一起，排查成本高。这个 skill 只保留一个原子动作 coupon_fabric，用于查询面料券信息，返回以接口响应为准。它适合上层 agent 把多个接口动作编排成完整链路，而不是自己承担库存、价格、订单号、优惠金额或物流状态的推断。

如何工作

调用固定正式环境地址 GET https://www.kutetailor.com/api/coupon/coupon/couponFabric，地址来自 frontmatter 的 base_url，不接受用户输入覆盖。tool arguments 统一使用嵌套 params 对象：最外层只有 params，不使用 params.xxx 这类点号顶层 key。登录态通过 params.accessToken 生成 Authorization: Bearer ；如果传入值已含 Bearer，不重复拼接。参数分类写入 params.path、params.query、params.body、params.headers。当前接口为 GET /coupon/couponFabric，Query 参数为 fabricCode、couponId，用途是查询面料券信息。POST/PUT 默认发送 JSON body；若上层网关另有约定，以网关契约为准。

适用边界与注意点

这是查询或计算类接口，但仍要遵守当前登录态、租户和用户权限。执行器必须使用固定正式环境地址，不要按用户输入改 base_url。返回结果必须以接口响应为事实来源，不要补造库存、价格、订单号、优惠金额或物流状态。如果遇到认证、权限、参数或业务错误，应把原始错误码和错误信息传给上层 agent。需要完整业务链路时，应由上层 agent 按聚合 skill 或计划文档编排多个原子 skill，本 skill 只完成本接口调用并把关键返回字段交给后续 skill。