Agent Skills
返回列表
优惠券冻结金额列表

优惠券冻结金额列表

企业运营 更新于 2026.08.29

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

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

技能介绍

解决什么问题

运营团队在做优惠券预算和对账时,常需要确认「某个用户当前有多少钱被冻结在优惠券钱包里」。这类数据分散在后端接口中,人工查询容易遗漏上下文参数,也难以保证登录态与租户隔离的正确性。list_frozen_price 将这个查询动作收敛为一个最小颗粒度的接口 skill,让 Agent 在需要时直接拿到当前用户的冻结金额列表。

技能如何工作

该 skill 只封装一个原子动作:

  • 调用地址:正式环境固定为 GET https://www.kutetailor.com/api/coupon/coupon-member/listCouponFrozenPrice,写在 frontmatter 的 base_url 中,不接受用户输入覆盖。
  • 参数传递:所有 tool arguments 统一嵌套在 params 对象里,外层不出现 params.xxx 这类点号 key。登录态使用 params.accessToken 生成 Authorization: Bearer,若传入值已含 Bearer 则不重复拼接。
  • 路由约定:Path 参数写入 params.path,Query 写入 params.query,JSON Body 写入 params.body,额外 Header 写入 params.headers。GET/DELETE 的查询参数走 URL query,POST/PUT 默认发送 JSON body。
  • 返回处理:以上层接口响应为唯一事实来源,不补造金额、库存或订单号等字段;若返回认证、权限、参数或业务错误,原样透传错误码与错误信息给上层 agent。

适用边界

这是一个查询或计算类接口,不是完整业务流程。当用户需求涉及多个接口步骤时,本 skill 只完成当前这一步,并把关键返回字段交给后续 skill 或上层聚合 skill(如 platform-coupon-wallet)编排。调用时仍需遵守当前登录态、租户和用户权限约束。

使用场景

  • 运营同学做月度优惠券预算对账,需要拉取指定用户当前钱包中被冻结的金额明细。
  • 上层 Agent 在做优惠券钱包聚合任务时,需要先取当前用户的冻结金额列表再继续后续接口。
  • 客服在处理用户“为什么我的券被冻结”咨询时,需要按当前登录用户查询冻结金额清单。
  • 对账脚本需要核对优惠券钱包冻结金额与订单扣减是否一致,只取冻结金额列表做比对。

适合人员

  • 优惠券运营专员,需要按用户核对冻结金额并解释冻结原因。
  • 平台后端工程师,要在自己的服务里集成冻结金额查询接口。
  • 做优惠券聚合能力的 Agent 开发者,需要调用原子接口完成链路编排。
  • 财务对账人员,关注冻结金额与实际扣减是否一致。