Runtime Logic
THX Amazon 助手 运行逻辑
这页说明 THX-amazon-assistant 收到任务后会解析哪些字段、使用哪些数据源、按哪些规则自检，方便定位问题和后续改规则。
THX Skill使用说明运行逻辑
运行逻辑页用于理解 Skill 的判断边界；日常使用请回到说明页下载或安装 Skill。
1
先解析什么
| 字段 | 说明 |
|---|---|
| ASIN / 商品链接 / 站点 | 作为任务分流和后续输出的必要字段。 |
| 任务类型：看链接、巡检、竞品、排名、广告、利润、掉量 | 作为任务分流和后续输出的必要字段。 |
| 自家商品还是外部竞品 | 作为任务分流和后续输出的必要字段。 |
2
核心链路
ASIN / 商品链接 / 站点 -> 判断任务类型 -> 选择必要规则和数据源 -> 生成结果 -> 自检缺失项 -> 输出下一步动作
3
会用哪些数据或规则
| 类别 | 处理方式 |
|---|---|
| 来源 | 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 |
4
如何自检
- 前台可见问题、后台事实或经营数据按数据源分开标注
- 结论先行，再给证据、data_gaps、下一步运营动作和需要人工确认项
- 月度复盘先列数据源、时间范围、筛选条件、返回行数、关键字段和 cache/data_freshness，再做业务判断
- 缺失字段明确标缺，不编造排名、销量、利润、广告数据
- 如果关键字段缺失，必须标注“待确认”或“当前无法校准”。
- 如果需要 MCP 但当前不可用，必须区分安装问题、服务问题和业务规则问题。
5
反馈如何沉淀
| 反馈类型 | 处理方式 |
|---|---|
| 单次输出不满意 | 保留本次输入和失败点，用于局部返修。 |
| 可复用规则 | 整理成 Skill 规则候选，确认后更新 Skill。 |
| 公司事实变化 | 走 GBrain 待审核候选，不直接写入正式主库。 |