酷特海外运营·我的优惠券分页
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kutesmart/kutesmart-platform-coupon-wallet-my-coupon-page。
技能介绍
要解决什么问题
在海外运营场景里,会员中心或客服侧经常需要按页拉取「我的优惠券」,而不是一次性 dump 全量数据。若 agent 直接拼 HTTP,容易踩坑:正式环境域名被用户输入覆盖、Query 与 Path 混写、Bearer 重复拼接,以及把分页结果当成完整业务结论去「补全」优惠金额或可用状态。
本 skill 是 platform-coupon-wallet 聚合链路里的原子动作,只负责 my_coupon_page 这一刀:用固定正式环境地址发起 GET,把接口原样返回交给上层编排。
如何工作
- 动作:
my_coupon_page,方法GET,路径/coupon-member/couponMemberPage。 - 参数:tool 入参统一放在嵌套
params里;分页与筛选条件走params.query(对应CouponMemberListRequest);登录态用params.accessToken生成Authorization: Bearer(值里已有 Bearer 则不再拼接)。 - 返回:以响应体为准,类型语义为分页结构
IPage;关键字段留给后续 skill 做核销、详情或状态判断。 - 执行约束:
base_url只读 frontmatter 中的正式环境地址,禁止覆盖;认证、权限、参数或业务错误时,把原始错误码与信息向上传递,不在本层改写业务叙事。
适用边界
- 用户需求若涉及领券、核销、钱包汇总等多步流程,本 skill 只完成分页查询一步,完整链路需由上层 agent 按聚合 skill 或计划文档组合多个原子 skill。
- 这是查询类接口,仍受当前租户、用户权限与登录态约束;未授权或 token 失效时,应依据接口错误响应处理,而非本地臆造列表数据。
使用场景
- 会员中心 agent 需要按页展示「我的优惠券」,用 Query 传入分页条件并解析 IPage 列表字段
- 客服工单里要核对某会员当前持有券列表,先调分页接口再交给详情或核销 skill
- 编排 platform-coupon-wallet 链路时,上层计划把 my_coupon_page 作为查券清单的第一步
- 运营排查「券包为空」投诉时,用固定正式环境 GET 拉取该用户优惠券分页原始响应
适合人员
- 对接 kutetailor 海外会员中心的 backend/agent 工程师,需在链路里稳定调用优惠券分页接口
- 维护 platform-coupon-wallet 聚合 skill 的集成同学,要插入原子动作 my_coupon_page 并传递 accessToken
- 海外运营侧客服工具 builder,要在对话流里分页查询会员优惠券再转人工核对
- 做优惠券域多 skill 编排的 agent 设计者,需明确本 skill 只负责分页查询、不代做领券或核销