Agent Skills
返回列表
海外运营平台 · 用户优惠券详情

海外运营平台 · 用户优惠券详情

企业运营 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_ac9585d3/platform-coupon-wallet-coupon-detail。

技能介绍

要解决什么问题

在海外运营平台的优惠券钱包链路里,客服、运营或自动化 agent 经常需要「按用户已领取的券」查一张券的完整详情——例如核销前核对规则、排查用户投诉、或在多步流程里把券状态交给下一步。若每次都手写 HTTP 调用,容易搞错 Path、登录态 Header 或正式环境域名。

本 skill 只做一件事:根据 couponMemberId 调用正式环境固定接口,拿到接口真实返回,不做业务臆造。

如何工作

  • 动作:coupon_detail
  • 请求:GET https://www.kutetailor.com/api/coupon/coupon-member/getCouponByCouponMember/{couponMemberId}
  • 参数约定:tool 参数统一放在嵌套对象 params 里;Path 变量写入 params.path(此处为 couponMemberId);登录态用 params.accessToken 生成 Authorization: Bearer …(若已含 Bearer 则不重复拼接)
  • 环境约束:base_url 以 skill frontmatter 中的正式环境为准,不接受用户输入覆盖
  • 返回:以接口响应为事实来源;若出现认证、权限、参数或业务错误,应把原始错误码与错误信息交给上层 agent

需要查列表、发券、核销等多步能力时,应由上层 agent 按聚合 skill(如 platform-coupon-wallet)或计划文档编排多个原子 skill;本 skill 只完成「查券详情」这一步。

适用边界与注意点

  • 这是查询类接口,仍受当前登录态、租户与用户权限约束
  • 不要在本层补造库存、价格、订单号、优惠金额或物流状态
  • GET 的查询参数应走 URL query;本接口核心 Path 为 {couponMemberId}

使用场景

  • 客服收到海外用户投诉某张券无法使用时,已有 `couponMemberId`,需拉取该用户券的接口详情核对规则与状态
  • 编排「查列表 → 查详情 → 核销」链路时,上层 agent 在拿到会员券 ID 后调用本 skill 获取 RS 再交给后续步骤
  • 运营排查营销活动中单张异常券时,按用户领取记录中的券成员 ID 查询正式环境券详情作事实依据
  • 自动化脚本在退款或改价流程中,需确认某张用户券的面额、有效期等字段后再写入内部工单

适合人员

  • 负责 Kutetailor 海外站用户券咨询的客服,需要在工单里按券成员 ID 核对接口返回的券规则与状态
  • 维护 `platform-coupon-wallet` 聚合 skill 的 agent 开发者,要把「查用户券详情」拆成可复用的单接口原子步骤
  • 海外运营在活动复盘时,需对单张用户券做正式环境详情查询,避免手工拼 URL 和 Bearer 头
  • 搭建多步优惠券业务链路的集成工程师,只需 `coupon_detail` 一步并向上层透传原始错误码