竞争店铺规划深度分析 · 使用前必读
====================================

【这个技能解决啥】
把一个淘宝 / 天猫竞品店铺的「全店链接原始数据表」自动拆解成一份
12-Sheet 的《竞争店铺规划深度拆解》Excel。
不是普通词频统计，也不是单一类目拆解，而是从
「全店指标 → 订单分层 → 子类目结构 → 词根词路 → 经营角色 → 竞争机会 → 行动优先级」
七段逻辑输出的完整经营深拆表，可直接用于选品 / 对标 / 投放决策。

【你要准备啥数据】
一张竞店「全店链接原始数据表」（Excel .xlsx），
字段至少含：商品标题、现价/原价、收货人数、同款数、类目、店铺名。
数据来源：店透视插件导出 / 生意参谋竞店监控 / 手动整理。
详见同目录《数据准备清单.md》。

【去哪找数据】
- 店透视（Chrome 插件）：打开竞店首页 → 批量导出全店商品链接表
- 生意参谋：市场 → 竞店分析 → 竞店宝贝 → 勾选指标 → 导出
- 字段不足时脚本仍能跑（缺字段的 Sheet 留空或标注"数据缺失"）

【怎么跑】
方式一（推荐，让 Agent 跑）：
  把数据表丢给 WorkBuddy，说"做竞争店铺规划深度分析"，
  Agent 会参考 scripts/build_store_planning_deep_analysis.py 生成 12-Sheet Excel。

方式二（直接命令行）：
  python scripts/build_store_planning_deep_analysis.py \
    --input 你的数据表.xlsx \
    --output 输出.xlsx \
    --shop 店铺名

【产出说明】
- 运行后会生成 **两份** 产物：
  ① `输出.xlsx`（12-Sheet 深度拆解表）
  ② `输出_洞察报告.html`（青绿版洞察报告，从表格提炼核心结论，可直接发给老板/运营看）
- 只给 Excel 不够，HTML 报告才是"总结出来的东西"。

【重要提醒】
1. 输出默认 12 个 Sheet，不要只做前 7 张基础表就停——
   后 5 张增强表（经营角色 / 竞争机会 / 行动优先级等）才是"深拆"价值所在。
2. Sheet 命名严禁带数字前缀（如"1-销售数据指标看板"是错的，应为"销售数据指标看板"）。
3. 输入表必须是一张"全店"表，不是某个子类目的局部表。
4. 报告里所有"店铺名"会写进 Sheet 大标题，记得用 --shop 或在对话里告诉 Agent 真实店铺名。
5. 本技能 v3.1 已全类目通用 + 双产出：不同类目自动套用不同词库与方法论板；价格列可选，缺失不报错；运行后除 Excel 外还会生成一份青绿版 HTML 洞察报告（结论自动提炼）。如不需要 HTML 加 `--no-html`。

【FAQ】
Q：脚本报"找不到输入文件"？
A：用 --input 指定正确路径，或把文件命名为"输入文件路径.xlsx"放脚本同目录。

Q：我只想看前 7 张表行不行？
A：不建议。本技能定位就是"深拆"，缺后 5 张等于没做完。如确需可手动删 Sheet。

Q：词根是机械切出来的吗？
A：脚本已内置品牌/品类/人群/场景/材质/功能分类与 emoji 前缀，
   但标题质量依赖输入准确率，脏标题会产出脏词根。

────────────────────────
🔒 对外发布必须先脱敏
本技能输出含 店铺名 / 买家昵称 / 商品ID / 精确销量 等敏感信息。
凡发 会员群 / 朋友圈 / 公众号 等任何对外渠道，必须先用通用脱敏器生成「_脱敏版」再发：
  python <电商运营顾问技能库根目录>/_shared/desensitize_report.py <你的输出文件或目录> --shops "真实店铺名1,真实店铺名2"
（买家昵称用 --nicks 显式给；商品ID/链接/销量自动处理）
详见 _shared/脱敏使用说明.md。内部经营分析（footer 已声明仅限内部）可用原版。
