优惠券冻结金额列表
将以下提示词粘贴到你的 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 开发者,需要调用原子接口完成链路编排。
- 财务对账人员,关注冻结金额与实际扣减是否一致。