海外优惠券钱包合并列表
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-coupon-wallet-coupon-all-page 到 AI 助手中。
技能介绍
解决的具体问题
海外运营平台里,优惠券往往不是单一列表:运营同学需要在“我的券”中核对已领取权益,又需要在“待抢券”中跟进可争取资源。若分别请求两套入口,上层 Agent 就要处理两套返回结构、分页字段和状态口径,组合成同一业务视图时很容易出现口径漂移。本技能把这类诉求收敛为一个最小颗粒度接口动作 coupon_all_page,让“我的券和待抢券合并列表”变成一次明确、可追踪的调用。
技能如何工作
它只负责 coupon_all_page 这个原子接口:GET https://www.kutetailor.com/api/coupon/coupon-member/couponAllPage。请求参数统一放入嵌套 params,不要使用 params.xxx 这类点号顶层 key。正式环境地址由 frontmatter 的 base_url 固定,不接受用户输入覆盖。
关键执行约束:
- 登录态使用
params.accessToken生成Authorization: Bearer;传入值已含Bearer时不重复拼接。 - Path 参数写入
params.path,Query 写入params.query,JSON Body 写入params.body,额外 Header 写入params.headers。 - 当前接口为
GET /coupon-member/couponAllPage,Query 对应CouponMemberListRequest,返回IPage。 - 返回结果以接口响应为事实来源,不补造库存、价格、订单号、优惠金额或物流状态。
- 若返回认证、权限、参数或业务错误,把原始错误码和错误信息传给上层 Agent,避免链路静默吞错。
适用边界
这是一个原子技能,不是完整业务编排。如果需求还包含领券、抢券、发券、风控或后续履约,应由聚合 skill platform-coupon-wallet 或上层 Agent 按计划把多个原子技能串起来。当前输入只描述“我的券和待抢券合并列表”时,本技能只完成该接口调用,并把关键返回字段交给后续 skill 或分步索要流程。
使用场景
- 用户询问我的券和待抢券合并列表时,调用 coupon_all_page 获取 IPage 数据
- 构建优惠券钱包聚合链路时,需要先取我的券与待抢券合并列表
- 分步索要优惠券列表字段时,需要先通过本接口取得合并列表返回
- 核对用户优惠券时,需要读取我的券和待抢券合并列表并交后续处理
适合人员
- 海外运营平台的优惠券运营,需要核对用户的我的券和待抢券合并状态
- Agent 工程师,要把 coupon_all_page 编排进优惠券钱包聚合 skill
- 业务系统对接方,需要调用合并列表接口完成优惠券页面展示
- 接口测试工程师,需要验证 coupon_all_page 的登录态和错误码传递