用途
该技能分析退货的处理结果，计算换货（保留收入）、店铺积分（递延收入）与退款（损失收入）之间的比例，并将其作为收入挽回指标随时间跟踪。该技能为只读，不执行任何变更操作。
主要能力
- 查询指定时间窗口内的退货记录，读取其退款金额、换货行项目及处理状态。
- 将每个退货归类为：换货（存在数量大于 0 的换货行项目）、店铺积分（退款中包含礼品卡或店铺积分支付）、退款（现金/卡退款且无换货）。
- 计算收入挽回率，即换货与店铺积分合计占全部退货的百分比。
- 可选与上一周期对比，用于观察趋势。
- 输出人类可读摘要或 JSON，并生成 CSV 明细文件。
使用方式
前置条件：已认证的 Shopify CLI 会话，命令为 shopify store auth --store <domain> --scopes read_orders,read_returns；API 权限范围为 read_orders、read_returns。
参数：
store（字符串，必填）：店铺域名，例如 mystore.myshopify.com。days_back（整数，可选，默认 30）：退货处理结果的回溯窗口。compare_days_back（整数，可选，默认 0）：可选的上一周期用于对比，0 表示不对比。format（字符串，可选，默认 human）：输出格式，human 或 json。
工作流程：先查询退货（returns 操作），输入查询条件 created_at:>='<NOW - days_back days>'，每页 250 条并使用游标分页，获取退货的退款金额、换货行项目与处理状态；然后按上述规则归类；若 compare_days_back > 0，再以相同逻辑查询上一周期的订单（orders 操作）以计算趋势。
GraphQL 操作：returns:query 与 orders:query，均针对 api_version 2025-01 验证。
会话跟踪：Claude 必须在每个阶段输出指定格式的提示信息，包括开始时的技能名称、店铺域名、启动时间，每步执行后的操作名称、参数摘要与结果，以及完成后的汇总。
输出格式：生成 CSV 文件 exchange_refund_ratio_<YYYY-MM-DD>.csv，列为 return_id, order_name, resolution_type, exchange_sku, refund_amount, currency, created_at。human 格式输出总退货数、换货/店铺积分/退款的数量与百分比、收入挽回率；json 格式输出结构化字段。
适用场景
- 衡量退货政策或换货激励措施对收入挽回率的影响。
- 结合退货原因分析，识别因尺码指引问题导致的低换货率。
- 在推出换货激励（例如换货赠送店铺积分）前后运行，评估效果。
限制
- 只读技能，不执行任何变更操作。
- 需要有效的 Shopify CLI 认证与相应 API 权限。
- 若窗口内无已处理退货，则以 0 条退货的摘要退出。
- 若换货行项目为空但状态显示为换货，视为进行中，计为待处理并排除在比例之外。
- 遇到 THROTTLED 错误时，等待 2 秒并最多重试 3 次。
- 收入挽回率高于 30%（换货加店铺积分）通常对时尚/服饰类是一个强信号，但应根据自身品类设定基准。