THX Skill Docs
THX Amazon 助手
查链接、Listing 巡检、竞品对比、关键词排名、销量利润、广告日报、月度复盘、掉量排查、新品验收，以及通过 8 个只读运营 wrapper 做 SKU 健康、广告异常、退货退款、关键词机会和月度导表复盘。
THX Skill使用说明运行逻辑
这个 Skill 需要先确认对应云端数据服务可用，再导入 Skill zip。普通同事不填写内部凭据；具体开工检查以本页说明为准。
1
使用定位
Skill zip 由管理员按需发放；公开页面不提供 zip 下载链接。拿到文件后不要解压，按本页安装步骤导入。
2
第一次怎么用
第一次直接按下面示例发起任务；需要开工检查的 Skill，先发送开工检查。
AMZ开工检查。检查通过后，请拉取 2026-05 Amazon 月度复盘三张表：父 ASIN 订单利润、广告 Campaign 汇总、广告组合汇总。先列数据源、时间范围、筛选条件、返回行数、关键字段、cache.status 和 data_freshness，再做异常产品和广告复盘。
3
需要提供什么
ASIN / 商品链接 / 站点
如果这项不明确，Skill 应该先标为待确认，而不是自己补事实。
任务类型：看链接、巡检、竞品、排名、广告、利润、掉量
如果这项不明确，Skill 应该先标为待确认，而不是自己补事实。
自家商品还是外部竞品
如果这项不明确，Skill 应该先标为待确认，而不是自己补事实。
4
输出内容
- 前台可见问题、后台事实或经营数据按数据源分开标注
- 结论先行，再给证据、data_gaps、下一步运营动作和需要人工确认项
- 月度复盘先列数据源、时间范围、筛选条件、返回行数、关键字段和 cache/data_freshness，再做业务判断
- 缺失字段明确标缺，不编造排名、销量、利润、广告数据
5
数据和规则边界
| 来源/规则 | 说明 |
|---|---|
| 数据来源 | amazon_sku_health 看 SKU / ASIN 健康 |
| 数据来源 | amazon_ad_anomaly 看广告异常 |
| 数据来源 | amazon_listing_competitor_signal 看 Listing / 竞品信号 |
| 数据来源 | amazon_refund_return_anomaly 看退货 / 退款异常 |
| 数据来源 | amazon_keyword_opportunity 看关键词机会 |
| 数据来源 | amazon_monthly_parent_asin_profit 看父 ASIN 月度订单利润导表 |
| 数据来源 | amazon_monthly_ads_campaigns 看月度广告 Campaign 汇总导表 |
| 数据来源 | amazon_monthly_ads_portfolios 看月度广告组合 / Portfolio 汇总导表 |
| 数据来源 | Sorftime Amazon 看外部 ASIN、关键词、流量词、趋势和类目证据 |
| 数据来源 | Firecrawl、SP-API、领星 ERP、Amazon Ads、Decodo 按任务需要补证据 |
| 使用规则 | 开工检查必须确认 tools/list 里有 8 个 amazon_* wrapper 和 Sorftime Amazon 只读 wrapper |
| 使用规则 | tools/list 不能出现 boss_*、CEO 聚合、raw 底层工具或写操作 |
| 使用规则 | 月度复盘默认先调用三张月度 wrapper，并先输出数据源、时间范围、筛选条件、行数、字段、cache.status 和 data_freshness |
| 使用规则 | 历史月份优先复用缓存/快照；需要重拉时使用 refresh_cache=true，并说明可能存在后台快照时间差或名称漂移 |
| 使用规则 | 看链接快速检查优先 Firecrawl；外部市场/关键词/竞品信号优先 Sorftime Amazon |
| 使用规则 | 外部竞品不查领星和 Ads |
| 使用规则 | 广告日报只有明确出现广告、ACOS、花费、转化等意图才调用 Ads |
| 使用规则 | Apify 暂未接入，不影响当前 read-only MVP |
6
反馈方式
如果输出不符合业务习惯，反馈时说清楚原始任务、哪里不对、以后希望固定怎么处理。
请根据这次测试结果修改 THX-amazon-assistant 的规则：
【我输入的任务】
粘贴原始任务
【当前输出的问题】
说明哪里不对，最好附截图或原文
【以后固定这样处理】
写成长期规则
【保留不变的部分】
说明哪些格式、字段或判断逻辑不要动