用途 该技能用于从 Shopify 订单的税务行中汇总指定期间内按税收管辖区（州/省、国家）和税率分组所收取的税额，产出一份适用于周期性税务申报准备的分组摘要。技能为只读操作，不执行任何变更。
前置条件 需要已认证的 Shopify CLI 会话，命令为：shopify store auth --store <domain> --scopes read_orders。所需 API 权限范围为 read_orders。
参数 参数包括：store（字符串，必填，店铺域名，例如 mystore.myshopify.com）；days_back（整数，可选，默认90，回溯窗口，可用30/90以匹配申报周期）；group_by（字符串，可选，默认 jurisdiction，可选值为 jurisdiction 或 rate）；exclude_refunded（布尔值，可选，默认 true，排除全额退款订单的税额）；format（字符串，可选，默认 human，可选值为 human 或 json）。
安全性 该技能为只读，不执行任何变更，可随时安全运行。报告仅用于内部准备，实际申报义务应咨询税务专业人士。
工作流程 首先查询 orders，输入条件为 financial_status:paid 且 created_at 在指定回溯窗口内，first 为 250，选取 taxLines（title、rate、priceSet）、refunds（refundLineItems）及分页游标。预期输出为所有已付款订单及其税务行，持续分页直到 hasNextPage 为 false。若 exclude_refunded 为真，则减去全额退款订单的税额。随后按 group_by（管辖区名称或税率）分组，并对 taxLine.priceSet.shopMoney.amount 求和。
GraphQL 操作 提供了针对 api_version 2025-01 验证的 orders 查询，包含订单的 id、name、createdAt、displayFinancialStatus、totalTaxSet、taxLines、shippingAddress 及 refunds 字段，并包含 pageInfo 分页信息。
会话跟踪 要求 Claude 在每个阶段输出规定的信息：开始时输出技能名称、店铺域名与开始时间；每步之后输出步骤进度、操作名、参数摘要与结果；完成时输出人类可读的税务负债摘要或 JSON 格式结果。
输出格式 生成 CSV 文件 tax_liability_<YYYY-MM-DD>.csv，列为 jurisdiction、country_code、province_code、tax_rate、order_count、total_tax_collected、currency。
错误处理 THROTTLED 表示超过 API 速率限制，需等待2秒并重试最多3次。订单无税务行可能因为未配置税或免税订单，对这些订单报告为 $0。部分退款订单的税额计算复杂，需在输出中标记；若 exclude_refunded 为 true 则从总额中排除。
最佳实践 该报告反映从客户收取的税额，不能替代 Shopify Tax 或专业的关联分析。days_back 应与申报周期一致（月报为30天，季报为90天）。对于美国多州商户，在依赖此输出前应确认 Shopify Tax 已针对每个关联州正确配置。taxLines.title 中的 jurisdiction 字段由 Shopify Tax 设置，通常包含州/省名称，需验证其格式与申报系统一致。