技能介绍

解决的核心问题

在构建海外运营平台的优惠券钱包时，获取用户的“我的优惠券”列表涉及严格的分页逻辑与多租户上下文校验。如果让大模型直接拼装复杂的业务链路，极易出现接口路由错误或查询参数遗漏。该技能将 my_coupon_page 这一原子动作单独剥离，确保在编排完整业务流时，每一步的底层数据获取都精准且符合网关契约。

工作机制与参数编排

技能的核心是封装 GET /coupon-member/couponMemberPage 请求。在调用时，执行器强制要求将参数收敛到统一的嵌套对象 params 中，严禁在顶层使用点号 key。具体参数路由规则如下：

请求体数据统一封装在 params.body
额外自定义头部挂载至 params.headers
登录态凭证通过 params.accessToken 传递

对于登录态鉴权，系统会读取 params.accessToken 自动生成 Authorization: Bearer 头部。若传入的 Token 已自带 Bearer 前缀，执行器会自动识别并避免重复拼接，从而有效防止因鉴权头格式错误导致的 401 异常。

适用边界与异常处理

作为最小颗粒度的原子技能，它仅负责单次接口调用，不包含前端分页组件的渲染或后续核销逻辑，这些需由上层 Agent 统筹编排。此外，技能严格以接口响应为事实来源，绝不会补造优惠金额或订单号。若接口返回认证失败、权限不足或参数错误，它会将原始错误码与信息原封不动地抛给上层 Agent，以便进行后续的重试或降级处理。同时，正式环境的 base_url 已固化在 frontmatter 中，禁止通过用户输入进行覆盖。