用途
该技能用于查询近期订单，筛选出 Shopify 欺诈分析标记为高风险或中风险的订单，并展示具体的风险指标（如账单/收货地址不匹配、高风险邮箱域名、高风险 IP 等）。最终生成一个按优先级排序的人工欺诈审核队列。该技能为只读操作，不执行任何数据变更。
主要能力
- 按风险等级（high、medium 或 all）筛选订单，默认仅包含高风险。
- 支持设置回溯天数（days_back，默认 7 天）和最低订单金额（min_order_value，默认 0，单位 USD）。
- 输出订单的风险等级、风险事实（riskFacts 的 message 与 sentiment）、总价、客户信息、收货与账单地址等。
- 按风险等级（高风险优先）和订单金额降序排序。
- 支持 human 或 json 两种输出格式，并生成 CSV 文件 risk_report_<YYYY-MM-DD>.csv。
使用方式
前置条件：需要已认证的 Shopify CLI 会话，命令为 shopify store auth --store <domain> --scopes read_orders，API 作用域为 read_orders。
参数：
- store（字符串，必填）：商店域名，例如 mystore.myshopify.com。
- risk_level（字符串，可选，默认 high）：最低风险等级，可选 high、medium 或 all。
- days_back（整数，可选，默认 7）：订单回溯窗口。
- min_order_value（浮点数，可选，默认 0）：仅包含高于此金额的订单（USD）。
- format（字符串，可选，默认 human）：输出格式，human 或 json。
工作流程：通过 GraphQL 查询 orders，使用查询条件 risk_level:<risk_level> created_at:>='<NOW - days_back days>'，每次取 250 条，分页直到 hasNextPage 为 false。随后按风险等级和订单金额排序。
GraphQL 操作（针对 api_version 2025-01 验证）：
query OrderRiskReport($query: String!, $after: String) {
orders(first: 250, after: $after, query: $query) {
edges {
node {
id
name
createdAt
displayFinancialStatus
displayFulfillmentStatus
totalPriceSet {
shopMoney {
amount
currencyCode
}
}
riskLevel
riskFacts {
message
sentiment
}
customer {
id
displayName
defaultEmailAddress {
emailAddress
}
numberOfOrders
}
shippingAddress {
countryCode
city
}
billingAddress {
countryCode
city
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
输出格式：CSV 文件 risk_report_<YYYY-MM-DD>.csv，包含列：order_name、order_id、created_at、risk_level、total_price、currency、customer_name、customer_email、risk_indicators、financial_status、fulfillment_status。
适用场景
- 每日运营例行检查，尤其是在促销高峰期欺诈尝试增多时。
- 构建人工欺诈审核队列，优先处理高风险、高金额订单。
- 通过 min_order_value 聚焦高价值订单的欺诈风险（多数商店 $50+ 是合理的下限）。
限制与注意事项
- 该技能为只读，不会自动取消或拦截订单。风险评分由 Shopify 欺诈分析生成，仅供参考，除非配置了 Shopify 欺诈过滤器，否则不会自动阻止订单。
- 不要自动取消高风险订单，建议先使用 high-risk-order-tagger 标记为人工保留，审核后再决定是否取消。
- 回头客（numberOfOrders > 3）的高风险评分通常是误报，需结合判断。
- 错误处理：THROTTLED（API 速率限制）时等待 2 秒并最多重试 3 次；无高风险订单时以摘要退出（0 个标记订单）；riskLevel 为 null（订单太新无法分析）时从报告中排除并记录数量。
- 会话跟踪：Claude 必须在各阶段输出指定格式的提示信息（开始、每步之后、完成时），human 格式输出订单风险报告摘要，json 格式输出包含 skill、store、period_days、orders_reviewed、high_risk_count、medium_risk_count、output_file 的 JSON。