sif-keyword-tracker

name	sif-keyword-tracker
description	Sif 关键词动态跟踪（Skill 2）。同一 ASIN 有历史时由 sif-keyword-scout 自动触发， 按 1~7 天窗口对比 PD 主攻词单，输出词库更新报告。Agent 必须写 insights_tracker.md， 且在写 insights 前完成暂停点 ③ 与用户确认投放策略。

Sif 关键词动态跟踪（Skill 2）

通常由 Skill 1 Step 10 触发。单独运行时同样遵循 暂停点 ③（见 scout 的 amazon-expert-guide.md）。

对比基准选择（1~7 天窗口）

python "{scripts.check_history}" --asin {ASIN} --output-dir "{output_dir}" --curr-date {DATE}

返回 compare_prev_result_dir、compare_note、compare_days_apart。

规则	说明
优先	按原数据日期（文件夹 YYYYMMDD / 原始表后缀）在 1~7 天窗口内选上一期，如 20260610 → 20260611
同日多次	仅当没有可比的异日数据时，才对比同日前一次运行（同日重跑）
超出窗口	回退到紧邻上一次异日数据（报告会标注 warning）

注意：0611 是数据日期，不是「今天跑脚本的日子」。对比的是两期 Sif 导出数据，不是同日重复执行。

两轮流程（与 Skill 1 相同）

第一轮：对比 + stats

python "{scripts.compare_versions}" --auto --output-root "{output_dir}" --output-dir "{result_dir}" --asin {ASIN} --curr-date {DATE} --skip-word

暂停点 ③（强制）

读取 {ASIN}_tracker_stats_{DATE}.json，向用户解读：

• 新增 / 消失词（含 S 级变化）
• SS 稳定词、搜索量与份额波动
• 试投 / 暂停 / 观察 建议

用户确认后才写 insights_tracker.md（必须针对本次数据，勿用模板凑数）。

第二轮：生成 Word

python "{scripts.compare_versions}" --auto --output-root "{output_dir}" --output-dir "{result_dir}" --asin {ASIN} --curr-date {DATE} --insights-file "{result_dir}/insights_tracker.md"

报告结构

• 数据段（脚本）：变化摘要、新增/消失清单（含 S 级）、SS 稳定词、搜索量/份额表
• AI 段（Agent）：策略解读、逐词建议、投放调整行动清单（须反映暂停点 ③ 与用户达成的共识）

产出

{result_dir}/{ASIN}_词库更新报告_{DATE}.docx