CoderAndyLee Amazon Review 分析
按 references/guide.md 做，不另起框架。分类列在分析中长出；层级必须是一级 / 二级 / 三级。
协议与报告结构只写在：
references/taxonomy-protocol.mdreferences/report-framework.md
产品化背景、数据合同、看板约定见 references/product-dev-spec.md。后续对话先读该文档，不要另起分类法或看板信息架构。
类目特例（配件词、地形怎么挂）写在 examples/，不要写回主流程。
输入
一个类目目录，至少：
1 Products/：BSR 或选品表（含 ASIN、品牌、标题、评分数）2 Reviews/：卖家精灵按 ASIN 导出的 xlsx
空目录骨架：templates/category-folder/。
先盘点：有多少 ASIN、下载条数 vs 站点评分数、是否混入配件、是否跨站点。样本缺口写进报告抬头。
流程
<skill> = 本仓库根目录。
1. 合并总表
python <skill>/scripts/merge_reviews.py \
--reviews-dir "<cat>/2 Reviews" \
--products-xlsx "<cat>/1 Products/<bsr>.xlsx" \
--out "<cat>/3 Data/reviews_master.xlsx"
保留 source_file。不要删行；配件型号、非美、VP、Vine 用 flag。
空 ASIN 用文件名里的 listing ASIN 回填，并保留 review 上的子 ASIN。配件旗标必须写窄，禁止用泛化词把整机场景打成配件。
2. 抽样开列（第 1 波）
python <skill>/scripts/sample_reviews.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--n 80 --out "<cat>/5 Work/wave1_reviews.json"
从空 taxonomy 开始标这批。目标是一级挂稳、二级开始长，不是锁死分类。
3. 逐条标注
精读每条的 标题 + 内容。输出 JSONL，一条 review 一个对象：
{
"row_id": 12,
"review_key": "https://...",
"sentiment_mix": "混合",
"assignments": [
{
"polarity": "好评",
"l1": "功能表现很好",
"l2": "贴边修剪干净",
"l3": "",
"excerpt": "edge cutting is excellent along the driveway",
"new_column": true
}
]
}
规则见 references/taxonomy-protocol.md。默认落到二级；三级少开。辩证评论两边都摘。
python <skill>/scripts/apply_annotations.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--annotations "<cat>/5 Work/wave1_annotations.jsonl" \
--batch wave1
4. 后续波次
python <skill>/scripts/export_pending.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--out "<cat>/5 Work/pending.json"
带着当前 taxonomy 继续标。对得上就复用列，对不上再加一级/二级/三级。
并行只允许发生在同一版词典之内。波次边界做近义对齐：
python <skill>/scripts/merge_columns.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--map "<cat>/5 Work/merge_map.json"
不要改成扁平标签，也不要第一波之后禁止加列。
5. 报告与看板
第一遍出骨架（统计层 + 01–06 的树 + 层级透视；sheet 编号自动连续）：
python <skill>/scripts/build_delivery.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--out-dir "<cat>/4 Reports" \
--html-template "<skill>/templates/review-analysis.html" \
--category "Robotic Lawn Mower" \
--marketplace US \
--date 2026/08/13
然后 Agent 精编文案，落成两份 json（不要直接改生成物）：
<cat>/5 Work/cards.json：六张卡，每张约 200 字，写判断不堆例子（同时渲染到看板「评论总结」区和09_评论总结）<cat>/5 Work/direction.json：hero：看板「买家口碑速读」的一句话 lead、chips、note；不写则脚本用一级频次自动生成board：精编后的 BOARD_DATA 分区（精选一级、二级 desc 写判断句、分区 lead）highlights/pains：07 的行动与新品方向，每条绑 1–2 条原声rows：11_产品方向 表行[类型, 优先级, 命题, 证据, n提示]source：品牌/ASIN 的note、years、models等精编字段brand_notes（06 读法列）、asin_meta（07 机型/一句话列）、readme_extra（00 补充行）均可选
第二遍带 json 重跑，得到成品交付（14 个 sheet，含 09_评论总结、11_产品方向）：
python <skill>/scripts/build_delivery.py \
--master "<cat>/3 Data/reviews_master.xlsx" \
--out-dir "<cat>/4 Reports" \
--category "Robotic Lawn Mower" --marketplace US --date 2026/08/13 \
--excerpts-cn "<cat>/5 Work/excerpts_cn.json" \
--cards-json "<cat>/5 Work/cards.json" \
--direction-json "<cat>/5 Work/direction.json"
看板标题不要写死类目名，也不要把类目文案写进 HTML 模板：「口碑速读」「评论总结」由 CARDS_DATA（cards.json + hero）渲染，评分盒由 SOURCE_DATA 渲染。PAGE_META 由 --title/--category/--marketplace/--date 传入。
Demo：examples/robotic-lawn-mower/（review-analysis.html + board-data.js，及可复现成品的 cards.json / direction.json）。
6. 收尾
核对：混合评论是否双边进列、摘录是否原文、taxonomy 的 first_row_id 是否可回溯、报告数字能否从总表透视。cards.json / direction.json 与类目特例一起归档进 examples/<category>/，保证成品可复现，不另起平行规则。
标注时的硬约束
- 单元格 = 原文摘录，不是模型复述
- 列名 =
极性|一级|二级或极性|一级|二级|三级 - 一级少而稳，二级是分析颗粒，三级只在二级不够聚类时加
- 星级不替代文本：5 星里的差评点、1 星里的好评点都要摘
- 不把抽样 ASIN 写成全类目结论，除非覆盖已经声明为全量