技能介绍

解决什么问题

亚马逊评论分散在多个站点和 ASIN，人工汇总耗时，情绪、主题与竞品差异容易混杂。该技能面向需要可追溯 VOC 结论的场景：给定 ASIN 与站点，先取得含采集和分析费用的报价，再执行采集、等待任务、生成结构化评论报告，并归档到用户中心，返回正文与 reportUrl。它不替代业务判断，而是把“样本数据—推导—建议”分开，避免把策略写成事实。

工作方式

技能以 CLI 为核心。每次会话先运行 check，确认账户、邮箱验证状态与可用积点。首次使用通过 setup 获取授权链接，由用户在浏览器登录或注册并点授权；Agent 只转告链接，不代登录，也不把 Key 写进报告或示例。默认 VOC 流程：对指定 --site 和 ASIN 运行 voc 取得总报价；用户确认后加 --confirm，命令自动补齐采集、等待完成、生成 VOC、保存报告，并返回完整正文、reportUrl、reportId 与消耗。仅当用户明确要单独采集、免费图表、深入分析或竞品对比时，才走 collect / charts / deepdive / analyze；竞品对比要求双方 ASIN 在库内各有 ≥10 条评论，并先报价后确认。归档报告用 reports 或 report --id 读取；完整交互与导出交给 Web 产品。

解读与边界

报告需区分 📊 数据直读、🔍 数据推理、💡 策略建议；reviewCount 等数字来自 ARI 已采集的 Amazon 评论样本，小样本或有限窗口时应结合更多信源验证。统计口径来自 _window.days；非 0 的 charts / deepdive 只覆盖该窗口，解读占比和趋势必须说明限制。付费中断后不能直接重试，服务端可能已扣点并归档；应先用 reports --asin <ASIN> --limit 1 确认没有新报告，再决定是否重跑。401/402/邮箱未验证/套餐级 429 等错误分别引导重建 Key、充值、验证邮箱、升级或降并发；ARI_COLLECTING 表示数据不足且本次未扣点。任何情况下不虚构 API 未返回的数据，不回退其他品牌接口；收到 update 字段时如实告知新版入口，但不自行下载或执行“新版”文件，升级只能由用户通过原渠道完成。