海外优惠券钱包·我的券与待抢券
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-coupon-all-page。
技能介绍
要解决什么问题
海外运营侧的优惠券钱包通常把「已领取的我的券」和「仍可抢的待抢券」拆在不同入口或接口里。若 agent 要在一次对话里帮用户盘点可用优惠、对比待领活动,就需要一个合并分页列表,而不是分别调两个列表再手工拼数据。
本 skill 对应酷特海外平台(正式环境 kutetailor.com)上的原子动作 coupon_all_page:只负责 GET /coupon-member/couponAllPage,返回 IPage 结构的分页结果。
技能如何工作
- 固定使用 frontmatter 中的正式环境
base_url,不接受用户输入覆盖域名。 - 调用参数统一放在嵌套对象
params里:Query 条件写入params.query(类型为CouponMemberListRequest),登录态通过params.accessToken生成Authorization: Bearer(若已含Bearer则不重复拼接)。 - 执行器按 GET 语义把查询参数拼到 URL;响应以接口返回为准,不补造库存、面额、订单号等业务字段。
- 若返回认证、权限、参数或业务错误,应把原始错误码与信息交给上层 agent 处理。
适用边界
这是最小颗粒度接口 skill,不包含领券、核销、详情页跳转等后续步骤。完整「优惠券钱包」链路需由上层 agent 参考聚合 skill platform-coupon-wallet 编排多个原子 skill。
使用场景
- 客服对话中需一次性列出会员已持有券与仍可领取的待抢券,避免分别查两个接口再手工合并
- 结账前由 agent 拉取 couponAllPage 分页结果,向用户说明当前可用优惠与待领活动
- 编排 platform-coupon-wallet 链路时,用本 skill 作为「券列表」原子步骤,再把关键字段交给领券或详情 skill
- 排查「看不到某张券」类工单时,按 CouponMemberListRequest 条件查询合并列表并对照接口原始返回
适合人员
- 对接酷特 kutetailor 会员体系的集成工程师,需要在 agent 中封装 couponAllPage 查询
- 海外电商客服或会员运营,在对话里帮用户核对「我的券」与「待抢券」合并视图
- 负责 platform-coupon-wallet 聚合 skill 编排的产品或 agent 设计,需明确列表原子接口边界
- 处理登录态、分页与权限错误的运维或二线支持,需把接口原始错误码透传给上层