Agent Skills
返回列表
酷特海外运营·我的优惠券分页

酷特海外运营·我的优惠券分页

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 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 只负责分页查询、不代做领券或核销