@optima-chat/optima-agent 0.9.36 → 0.9.38

package/.claude/skills/scout/references/concept.md

@@ -9,136 +9,188 @@
 - 新建研究项目时自动进入
 - RESEARCH.md 当前阶段 = 概念
 
-## 执行步骤
+## 流程总览
+
+```
+第一步：数据采集（步骤 1-4）
+    ↓
+第二步：数据完整性检查（必须全部通过才能继续）
+    ↓
+第三步：数据分析（步骤 5-7）
+    ↓
+第四步：CDCP Gate 评审
+```
+
+**绝对不能跳过数据完整性检查直接做分析。数据不完整的分析是误导性的。**
+
+---
+
+## 第一步：数据采集
 
 ### 1. 趋势扫描
 
 **目的**：从 Amazon 站外发现热度信号
 
-**具体命令**：
+**必须执行**：
 - `scout tiktok search-videos "关键词"` 或 `scout tiktok shop-search "关键词"`
 - `scout reddit trends "关键词"` 或 `scout reddit search "关键词"`
-- `scout twitter trends "关键词"` 或 `scout twitter search "关键词"`
-- Web Search（补充搜索趋势、新闻报道等）
-
-**分析要点**：
-- 讨论量增长趋势
-- 未满足需求（用户抱怨、求推荐）
-- 竞品投诉（质量差、功能缺失）
-- KOL 推荐（达人带货、测评视频）
 
-**落盘位置**：`data/social/{date}-tiktok.json`、`data/social/{date}-reddit.json`、`data/social/{date}-twitter.json`、`data/social/{date}-web.json` → 更新 `INDEX.md` + `market/MARKET.md`
-
-**完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）
+**可选补充**：
+- `scout twitter trends "关键词"`
+- `scout instagram reels "关键词"`
+- Web Search 行业报告和新闻
 
-**跨平台发现→验证链路：**
+**跨平台发现→验证链路**：
 - TikTok/Instagram 发现热度 → `scout search` 验证 Amazon 需求 → `scout supplier-search` 确认成本
 - Shein/Temu 发现低价爆品 → `scout search` 对比 Amazon 定价 → 判断品牌溢价空间
 - Reddit/Twitter 发现未满足需求 → `scout search` + `scout reviews` 验证痛点普遍性
 
+**落盘**：`data/social/{date}-{platform}.json` → 更新 `INDEX.md` + `market/MARKET.md`
+
+**完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）
+
 ---
 
-### 2. Amazon 市场扫描
+### 2. Amazon 市场全景扫描
+
+**目的**：全面了解市场，不遗漏重要竞品和子品类
+
+**必须执行**：
 
-**目的**：确认站内是否存在市场
+**A. 广度搜索**：
+- `scout search "主词" --limit 50`（拉满 50 条）
+- 至少 2-3 组关键词，每组 50 条
+- 去重后应覆盖 **30+ 个不重复 ASIN**
 
-**具体命令**：
-- `scout search "主词" --limit 15`
-- 至少 2-3 组关键词覆盖主要同义词
+**B. 精确搜索量**：
+- `scout sp keywords-mine "主关键词"` — 获取精确月搜索量、购买量、转化率、PPC 竞价
+- 对 2-3 个核心关键词都执行
 
-**分析要点**：
-- 产品数量（市场容量）
-- 价格分布（高/中/低档位占比）
-- 评分分布（平均星级、低分占比）
-- "bought in past month" 频率（需求热度）
-- 品牌重复度（垄断程度）
+**C. 竞品全景补充**：
+- 从搜索结果中选 1 个头部 ASIN，执行 `scout sp competitors <ASIN>` 拉取更多竞品的销量/销额/利润数据
+- 如命令返回无关数据，改用多关键词搜索补充
 
-**落盘位置**：`data/searches/{date}-{keyword}.json` → 更新 `INDEX.md` + `market/MARKET.md`
+**D. 子品类聚类**（关键步骤）：
+- 对搜索到的所有产品按**产品形态/功能/使用场景**做子品类分类
+- 目标 **5-10 个子品类标签**
+- 每个子品类标注：产品数量、价格区间、头部评论数、增长信号、竞争度
+- **子品类聚类是发现细分机会的关键步骤，不能跳过**
 
-**可选补充**：`scout sp keywords-mine "关键词"` 获取精确月搜索量、PPC 竞价和转化率，比搜索结果中的 "bought in past month" 更精确
+**落盘**：`data/searches/{date}-{keyword}.json` + `data/sellersprite/{date}-{keyword}-mine.json` → 更新 `INDEX.md` + `market/MARKET.md`
 
-**完成标准**：2-3 组关键词搜索覆盖主要同义词
+**完成标准**：覆盖 30+ 个不重复竞品，识别出 5+ 个子品类并标注各自规模
 
 ---
 
-### 3. 需求验证
+### 3. 竞争格局数据采集
+
+**目的**：量化竞争强度和竞争者构成
+
+**必须执行**：
+- `scout sp category "关键词"` — 查类目 nodeIdPath
+- `scout sp brands <nodeIdPath>` — 获取品牌集中度数据（各品牌 ASIN 数、销量份额、销额份额）
+- `scout sp seller-countries <nodeIdPath>` — 获取卖家国籍分布
+- `scout sp seller-types <nodeIdPath>` — 获取 FBA/FBM/Amazon 自营占比
+
+**落盘**：`data/sellersprite/{date}-brands-{nodeIdPath}.json` 等 → 更新 `INDEX.md` + `market/MARKET.md`
+
+**完成标准**：有品牌集中度（CR3/CR5 量化数据）+ 卖家国籍分布 + FBA 占比
 
-**目的**：用数据确认有真实购买行为
+---
+
+### 4. 供应端初探
 
-**具体命令/数据源**：
-- 搜索结果中的 "bought in past month" 数据
-- 可选：`scout keepa product ASIN1,ASIN2 --stats 90`（获取历史销量数据）
+**目的**：粗估成本，判断利润空间是否足够
 
-**分析要点**：
-- 月搜索量估算
-- BSR 分布（头部产品 BSR 越低 = 销量越大）
-- salesRankDrops（Keepa 销量掉落次数 ≈ 出单次数）
-- "bought in past month" 具体数值
-- 推荐：`scout sp keywords-mine "关键词"` 的 `searches`（精确月搜索量）和 `purchases`（月购买量）比 BSR drops 估算更直接
+**必须执行**：
+- `scout supplier-search "中文关键词" --limit 10` — 获取 1688 参考价
+- 记录：头部供应商价格区间、MOQ、供应商类型
 
-**落盘位置**：更新 `market/MARKET.md` 需求验证部分
+**落盘**：`data/suppliers/{date}-{keyword}.json` → 更新 `INDEX.md`
 
-**完成标准**：有具体月销量估算数据
+**完成标准**：有 1688 参考价（至少 3 家供应商报价）
 
 ---
 
-### 4. 竞争格局
+## 第二步：数据完整性检查
 
-**目的**：初步判断竞争强度
+**在做任何分析之前，必须通过以下检查。任何一项未通过 → 补数据，不分析。**
 
-**分析要点**：
-- 竞品总数
-- 头部产品评论数（评论数越多 = 护城河越深）
-- 品牌垄断情况（前 10 名是否被 2-3 个品牌占据）
-- 品牌集中度（CR3/CR5）
-- 可选：`scout sp category "关键词"` 查类目 nodeIdPath，然后 `scout sp brands <nodeIdPath>` 获取量化的品牌集中度数据（各品牌 ASIN 数、销量份额、销额份额）
-- 参考 `metrics.md` 竞争指标表
+```
+数据完整性检查清单：
+
+□ 搜索覆盖度：INDEX.md 中不重复 ASIN 数量 ≥ 30？
+□ 子品类聚类：MARKET.md 子品类分布表 ≥ 5 行？
+□ 精确搜索量：有 scout sp keywords-mine 数据（searches + purchases + bid）？
+□ 品牌集中度：有 scout sp brands 数据（CR3/CR5 + 份额）？
+□ 卖家国籍：有 scout sp seller-countries 数据？
+□ 供应端成本：有 1688 供应商报价（≥ 3 家）？
+□ 卖家类型：有 scout sp seller-types 数据（FBA/FBM 占比）？
+□ 趋势信号：有至少 2 个社交平台数据？
+□ 原始 JSON 落盘：data/ 目录文件数 ≥ 命令执行数？（每次命令都存了 JSON？）
+□ INDEX.md 一致：INDEX.md 中列出的文件在 data/ 目录中都存在？
+```
 
-**落盘位置**：更新 `market/MARKET.md` 竞争格局部分
+**如果有未通过的项，告知用户缺什么，补齐后重新检查。**
 
-**完成标准**：知道竞品数量、头部评论数、是否品牌垄断
+**输出格式**：
+```
+📋 数据完整性检查
+✅ 搜索覆盖度：42 个不重复 ASIN（≥ 30）
+✅ 子品类聚类：7 个子品类（≥ 5）
+✅ 精确搜索量：3 组关键词已有数据
+❌ 品牌集中度：未采集 → 需要执行 scout sp brands
+❌ 卖家国籍：未采集 → 需要执行 scout sp seller-countries
+✅ 供应端成本：5 家供应商报价
+✅ 趋势信号：TikTok + Reddit
+✅ 原始 JSON：12/12 已落盘
+✅ INDEX.md 一致
+
+结论：2 项未通过，需要补充品牌集中度和卖家国籍数据。
+```
 
 ---
 
+## 第三步：数据分析
+
+**只有数据完整性检查全部通过后，才进入分析阶段。**
+
 ### 5. SPAN 初步定位
 
 **目的**：战略定位评估
 
 **方法**：
 - 参考 `analysis-framework.md` SPAN 评分标准
-- SPAN 是一个 2×2 矩阵工具，两个轴：
-  - Y 轴：市场吸引力（1-5 分，含市场规模、增长趋势、利润潜力、战略价值）
-  - X 轴：竞争地位（1-5 分，含差异化能力、资金匹配度、供应链能力、进入壁垒）
-- 阈值：≥3.5 为"高/强"，<3.5 为"低/弱"
-
-**补充数据来源**：
-- 市场规模维度：可用 `scout sp keywords-mine` 的 searches 精确验证月搜索量，替代 BSR drops 估算
-- 竞争地位维度：可用 `scout sp brands` 的品牌份额数据辅助判断品牌垄断程度
-
-**注意**：概念阶段是初步评估，部分维度可以粗略打分，后续阶段再精确
-
-**落盘位置**：更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
-
-**完成标准**：两个维度都有评分
+- Y 轴：市场吸引力（1-5 分）
+  - 市场规模：用 `scout sp keywords-mine` 的 searches 精确验证
+  - 增长趋势：社交媒体热度 + 搜索结果中新品比例
+  - 利润潜力：1688 成本 vs Amazon 售价
+  - 战略价值：品类协同、复购潜力
+- X 轴：竞争地位（1-5 分）
+  - 差异化能力：子品类聚类中的空白机会
+  - 资金匹配度：对照 PROFILE.md
+  - 供应链能力：1688 供应商数量和质量
+  - 进入壁垒：用 `scout sp brands` 的品牌份额数据判断
+
+**落盘**：更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
 
 ---
 
 ### 6. 初步利润估算
 
-**目的**：粗算利润空间，判断是否值得做
+**目的**：粗算利润空间
 
 **方法**：
 - Amazon 均价（从搜索结果取中位数）
-- 1688 参考价（可选命令：`scout supplier-search "中文关键词" --limit 5`）
+- 1688 参考价（步骤 4 已采集）
 - FBA 费估算（按品类/尺寸估算）
-- 粗略毛利 = 售价 - 1688参考价 - FBA费 - 平台佣金（概念阶段只算毛利，计划阶段用 FAN 模型精算净利率）
-- 可选：`scout sp keywords-mine "关键词"` 的 `bid/bidMin/bidMax` 可以估算 PPC 广告成本，使利润估算更准确
-
-**对照**：`PROFILE.md` 中的最低毛利率要求。如果 PROFILE 未填写该阈值，提示用户确认："你的最低可接受毛利率是多少？（默认 50%）"
+- PPC 成本估算：用 `scout sp keywords-mine` 的 `bid` 数据
+- 毛利 = 售价 - COGS - FBA 费
+- 粗略净利 = 毛利 - PPC 估算 - 退货估算
 
-**落盘位置**：记录在 `RESEARCH.md` 关键发现中
+**对照**：`PROFILE.md` 中的最低毛利率和最低净利率。如果 PROFILE 未填写，必须让用户确认。
 
-**完成标准**：有售价 + 1688 参考价 + FBA 费估算
+**落盘**：记录在 `RESEARCH.md` 关键发现中
 
 ---
 
@@ -147,32 +199,27 @@
 **目的**：排除法律风险
 
 **方法**：
-- Web Search 查询：
-  - 商标注册情况（USPTO、WIPO）
-  - 外观专利（Design Patent）
-  - 品类认证要求（FDA、FCC、UL 等）
-  - Amazon 品类限制（Gated Category）
-- 检查是否有已知侵权风险
+- Web Search 查询：商标（USPTO/WIPO）、外观专利、品类认证（FDA/FCC/UL/CPSIA）、Amazon 品类限制
 
-**落盘位置**：记录在 `RESEARCH.md` 关键发现中（如有风险则同时记入风险清单）
-
-**完成标准**：确认无明显风险（或标注已知风险供后续深入调查）
+**落盘**：记录在 `RESEARCH.md` 关键发现中（如有风险则同时记入风险清单）
 
 ---
 
-## CDCP Gate 评审
+## 第四步：CDCP Gate 评审
 
 ### 触发条件
 
-7 个 checklist 项全部完成。
+1. 步骤 1-4 数据采集完成
+2. 数据完整性检查全部通过
+3. 步骤 5-7 分析完成
 
 ### 执行方式
 
 1. 读取 `analysis-framework.md` 的 CDCP 标准
 2. 逐一回答 5 个核心问题（引用数据支撑）：
-   - 市场存在吗？（需求验证数据）
-   - 能赚钱吗？（利润估算）
-   - 竞争打得过吗？（竞争格局分析）
+   - 市场存在吗？（精确搜索量 + 月购买量）
+   - 能赚钱吗？（利润估算，含 PPC 成本）
+   - 竞争打得过吗？（品牌集中度 + 卖家国籍 + 子品类空白）
    - 法律风险可控吗？（IP/合规初筛结果）
    - SPAN 可接受吗？（SPAN 评分）
 3. 给出 **Go / Kill / Redirect** 建议
@@ -186,13 +233,15 @@
 ```
 ## CDCP Gate 评审结果
 
+### 数据完整性：✅ 全部通过（10/10）
+
 ### 核心问题
 
 | # | 问题 | 结论 | 依据 |
 |---|------|------|------|
-| 1 | 市场存在？ | ✅/❌ | [具体数据：月销量、搜索量等] |
-| 2 | 能赚钱？ | ✅/❌ | [毛利率 XX%，满足/不满足最低毛利率要求] |
-| 3 | 竞争打得过？ | ✅/❌ | [头部评论数、品牌集中度等] |
+| 1 | 市场存在？ | ✅/❌ | [精确搜索量 XX/月，购买量 XX/月，转化率 XX%] |
+| 2 | 能赚钱？ | ✅/❌ | [毛利率 XX%，估算净利率 XX%（含 PPC $XX）] |
+| 3 | 竞争打得过？ | ✅/❌ | [品牌 CR3=XX%，XX% 中国卖家，子品类 XX 竞争空白] |
 | 4 | 法律风险？ | ✅/❌ | [专利/商标/认证情况] |
 | 5 | SPAN 可接受？ | ✅/❌ | [市场吸引力: X/5, 竞争地位: X/5, 象限: 投资/选择性投入/收割/退出] |
 
@@ -211,7 +260,7 @@
 ### 各决策结果的具体操作
 
 **Go：**
-1. **生成产品立项书**，保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含：市场概况、SPAN 定位、竞争格局、初步利润估算、机会与风险、Go 建议
+1. **生成产品立项书**，保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含：市场概况（含子品类分布）、SPAN 定位、竞争格局（含品牌集中度和卖家国籍）、初步利润估算（含 PPC）、机会与风险、Go 建议
 2. 更新 RESEARCH.md 当前阶段 → 计划
 3. 更新 RESEARCH.md 决策记录
 4. 更新 OVERVIEW.md 阶段列
@@ -228,7 +277,7 @@
 **Redirect：**
 1. 更新 RESEARCH.md 决策记录（记录调整原因和新方向）
 2. 根据调整幅度决定：
-   - **小调整**（如从"无线耳机"缩窄到"开放式耳机"）：修改当前项目的研究目标，重置概念阶段 checklist 中受影响的项（如竞争格局、SPAN），重新执行
+   - **小调整**（如从"无线耳机"缩窄到"开放式耳机"）：修改当前项目的研究目标，重置概念阶段 checklist 中受影响的项，重新执行
    - **大调整**（方向完全不同）：归档当前项目(No-Go)，新建项目重新开始
 3. 无论哪种，保留已有数据不删除（可能在新方向中有参考价值）
 
@@ -238,42 +287,43 @@
 
 **用户**："我想开店卖钛合金杯子，你觉得合适吗？"
 
-**步骤 1-2：趋势扫描 + Amazon 搜索**
+**第一步：数据采集**
 
-立即执行：
-- `scout search "titanium cup" --limit 15`
-- `scout search "titanium mug" --limit 15`
+立即执行数据采集（不做分析，只收集）：
+```bash
+# 趋势
+scout tiktok search-videos "titanium cup"
+scout reddit trends "titanium cup"
 
-分享发现：
-> "市场有 50+ 竞品，价格 $15-90，主要在 $20-30 区间。头部产品（TOAKS）月销约 200 件，BSR #530。两个方向：低价位($15-25)竞争激烈，高端保温款($60-90)产品很少。你更倾向哪个价位？"
+# 广度搜索
+scout search "titanium cup" --limit 50
+scout search "titanium mug" --limit 50
+scout search "titanium tumbler" --limit 50
 
-**步骤 3-4：用户回复后深入**
+# 精确搜索量
+scout sp keywords-mine "titanium cup"
+scout sp keywords-mine "titanium mug"
 
-用户："中高端的，质量好的"
+# 竞争格局
+scout sp category "titanium cup"
+scout sp brands <nodeIdPath>
+scout sp seller-countries <nodeIdPath>
+scout sp seller-types <nodeIdPath>
 
-执行：`scout product B0CTKWJDXX`、`scout product B0DNCMN3NX`、`scout product B083NLR6BF`
-
-分享：
-> "TOAKS 中端爆款 BSR #530，月销 250 件，87% 五星。用户最爱：超轻、品质好、无金属味。主要抱怨：散热快（无保温）。KOYASU 高端保温 $89.99，评论少但 4.8 分。保温款市场几乎空白！"
-
-**步骤 5：Keepa 历史验证**
-
-执行：`scout keepa product B0CTKWJDXX,B0DNCMN3NX,B083NLR6BF --stats 180`
+# 供应端
+scout supplier-search "钛合金杯子" --limit 10
+```
 
-分享：
-> "Keepa 数据显示：TOAKS 的 BSR 过去 6 个月从 #2000 降到 #530，市场在增长。卖家数从 3 增到 8，竞争在加剧但还不激烈。价格稳定在 $25-28，无价格战。保温款 KOYASU BSR 波动大但整体下降，刚起步有潜力。"
+每个命令执行后立即落盘（JSON + INDEX.md）。
 
-**步骤 6：供应商和成本**
+**第二步：完整性检查**
 
-用户："好的，你看看成本"
+> "📋 数据完整性检查：9/9 全部通过。可以开始分析了。"
 
-执行：
-- `scout search "titanium tumbler" --limit 10`
-- `scout supplier-search "钛合金保温杯"`
+**第三步：分析**
 
-分享：
-> "批发价区间 ¥180-450（约 $25-65），起订量 50-100 个。头部供应商：8 年工厂，¥280 批发价。**利润分析**：Amazon 售价 $70-90，1688 成本 ¥280（≈$40），运费+FBA 约 $15，总成本约 $55，毛利率 25-40%。"
+基于完整数据做 SPAN 评分、利润估算、IP 检查。
 
-**步骤 7：建议**
+**第四步：CDCP Gate 评审**
 
-> "概念阶段数据收集完毕。要不要立项做正式的 IPD 分析？我可以帮你做 SPAN 定位、$APPEALS 竞品评分和 FAN 财务模型。"
+逐项回答 5 个核心问题，给出 Go/Kill/Redirect 建议。

package/.claude/skills/scout/references/planning.md

@@ -15,28 +15,40 @@
 
 **目的**：全面掌握竞争格局，为后续分析建立数据基础
 
-**具体命令**：
-- `scout product ASIN`（对每个竞品逐一执行）
-
-**选品策略**：选 TOP 3-5 竞品
+**选品策略**：从概念阶段全景扫描的 30-50 个竞品中，选 **5-8 个**做深度分析：
 - BSR 最低 2-3 个（品类领导者）
 - 增长最快 1-2 个（新锐挑战者）
 - 定位接近 1-2 个（直接竞争对手）
+- 每个重点子品类至少选 1 个代表
 
-**分析要点**：
-- 定价策略（原价、促销价、优惠券）
-- BSR 排名及品类层级
-- 评分分布（星级比例、评论总数）
-- Feature Bullets 卖点提炼
-- 图片数量与质量
-- A+ 页面有无及质量
-- 变体布局（颜色/尺寸/套装）
+**步骤 A — 产品详情**：
+- `scout product ASIN`（对每个竞品逐一执行）
+- 分析要点：定价策略（原价/促销/Coupon）、评分分布、Feature Bullets、图片数量与质量、A+ 页面、视频、变体布局
+
+**步骤 B — 流量关键词**：
+- `scout sp keywords <ASIN>` 反查竞品流量关键词（含搜索量、竞价、自然排名、广告排名）
+- 分析要点：广告词数量（badges 含 "ads"）、自然排名 vs 广告排名差异、流量集中度
+
+**步骤 C — 历史销量与季节性**（关键！概念阶段缺失的数据）：
+- `scout sp predict <ASIN>` 获取 14 个月销量预测数据
+- 对 5-8 个竞品都拉取，识别**季节性规律**（如复活节/黑五/圣诞波峰）
+- 分析要点：
+  - 月销量是否有明显的季节波峰？
+  - 波峰出现在哪个月？（决定上架时间）
+  - 淡季 vs 旺季销量差多少倍？（影响备货策略）
+  - 销量是增长趋势还是下降趋势？
 
-**推荐补充**：`scout sp keywords <ASIN>` 反查竞品流量关键词（含搜索量、竞价、自然排名、广告排名），了解竞品的流量结构
+**步骤 D — Listing 能力矩阵**：
+- 对每个竞品记录以下能力项（从 `scout product` 结果提取）：
 
-**落盘位置**：`data/products/{ASIN}.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
+| ASIN | A+ | 视频 | 图片数 | Bullets 质量 | 品牌注册 | Coupon/促销 |
+|------|----|----|-------|------------|---------|-----------|
 
-**完成标准**：3-5 个竞品有完整数据
+- 这张表反映竞品的运营成熟度，A+ 和视频覆盖率高 = 竞争壁垒高
+
+**落盘位置**：`data/products/{ASIN}.json` + `data/sellersprite/{ASIN}-predict.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
+
+**完成标准**：5-8 个竞品有完整数据（产品详情 + 流量关键词 + 历史销量 + Listing 能力）
 
 **竞品分析 Checklist（对每个竞品逐项检查）：**
 - ✅ BSR 和品类排名 — 估算销量
@@ -193,11 +205,33 @@
 
 **完成标准**：主要风险识别，每个有应对方案
 
+## 数据完整性检查
+
+**在 PDCP Gate 评审之前，必须通过以下检查。任何一项未通过 → 补数据，不评审。**
+
+```
+计划阶段数据完整性检查清单：
+
+□ 竞品深度：5-8 个竞品有完整 product detail？
+□ 流量关键词：5-8 个竞品有 scout sp keywords 数据？
+□ 历史销量：5-8 个竞品有 scout sp predict 14 个月数据？
+□ 季节性分析：COMPETITORS.md 季节性分析表已填写？
+□ Listing 能力矩阵：COMPETITORS.md 能力矩阵表已填写？
+□ $APPEALS 评分：≥ 3 个竞品完成 8 维度打分？
+□ 差评分析：≥ 30 条差评已聚类？
+□ Keepa 趋势：有 180 天 BSR 趋势 + 生命周期判断？
+□ FAN 模型：单元经济 + 4 场景分析完整？（含真实 PPC 竞价）
+□ 供应商：≥ 1 家可行供应商？
+□ 差异化策略：COMPETITORS.md 差异化机会总结已填写？
+□ 风险清单：主要风险已识别且有应对方案？
+□ 原始 JSON 落盘：所有命令结果已存到 data/？
+```
+
 ## PDCP Gate 评审
 
 ### 触发条件
 
-8 项执行步骤全部完成。
+数据完整性检查全部通过。
 
 ### 评审问题（参考 `analysis-framework.md` PDCP 标准）
 

package/.claude/skills/scout/template/product/RESEARCH.md

@@ -17,23 +17,28 @@
 
 ### 概念阶段（产品立项书）
 - [ ] 趋势扫描（TikTok/Reddit/Twitter/Web Search 发现热度信号）
-- [ ] Amazon 市场扫描（关键词搜索覆盖）
-- [ ] 需求验证（月搜索量、BSR drops 估算月销）
-- [ ] 竞争格局（竞品数量、头部评论数、品牌集中度）
+- [ ] Amazon 市场全景扫描（多关键词 ×50 条 + 竞品补充，覆盖 30+ 竞品）
+- [ ] 子品类聚类（识别 5+ 子品类，标注各自规模和竞争度）
+- [ ] 需求验证（精确月搜索量、购买量、转化率）
+- [ ] 竞争格局（品牌集中度、卖家国籍分布、各子品类竞争强度）
 - [ ] SPAN 初步定位（市场吸引力 + 竞争地位）
 - [ ] 初步利润估算（毛利率 > PROFILE 最低毛利率?）
+- [ ] 供应端初探（1688 参考价，≥3 家供应商报价）
 - [ ] IP/合规初筛（商标、专利、认证要求）
+- [ ] **数据完整性检查通过**（10 项全部通过）
 - **CDCP Gate**: 市场够大？利润够高？竞争可打？无 IP 风险？
 
 ### 计划阶段（商业计划书）
-- [ ] 头部竞品深挖（TOP 3-5 产品详情）
-- [ ] $APPEALS 竞品评分（TOP 3-5 竞品 8 维度打分）
+- [ ] 头部竞品深挖（5-8 个，含产品详情 + 流量关键词 + Listing 能力矩阵）
+- [ ] 历史销量与季节性分析（14 个月销量数据，识别波峰波谷）
+- [ ] $APPEALS 竞品评分（TOP 5 竞品 8 维度打分）
 - [ ] 用户痛点挖掘（差评聚类 → 差异化方向）
 - [ ] 历史趋势分析（Keepa BSR/价格/卖家数 → 生命周期判断）
 - [ ] 差异化策略（基于 $APPEALS 缺口确定产品定位）
 - [ ] FAN 财务分析（单元经济、盈亏平衡、场景分析、回本周期）
 - [ ] 供应商初步接触（3-5 家询价、MOQ、交期）
 - [ ] 风险评估（竞争加剧、价格战、季节性、合规变化）
+- [ ] **数据完整性检查通过**（13 项全部通过）
 - **PDCP Gate**: 有明确差异化？供应商可行？商业计划书成立？
 
 ### 开发阶段（产品实现）

package/.claude/skills/scout/template/product/competitors/COMPETITORS.md

@@ -18,9 +18,16 @@
 | L 生命周期成本 | | | | | |
 | S 社会接受度 | | | | | |
 
-## Listing 质量对比
-| ASIN | 图片数 | A+ | 视频 | Bullets 质量 | 优化空间 |
-|------|--------|----|----- |------------|---------|
+## Listing 能力矩阵
+| ASIN | 图片数 | A+ | 视频 | Bullets 质量 | 品牌注册 | Coupon/促销 | 优化空间 |
+|------|--------|----|----- |------------|---------|-----------|---------|
+
+## 季节性分析（14 个月历史销量）
+
+| ASIN | 产品名 | 波峰月份 | 波谷月份 | 旺季/淡季倍数 | 趋势方向 |
+|------|--------|---------|---------|-------------|---------|
+
+{基于 scout sp predict 数据，分析季节规律和最佳上架时间}
 
 ## 差异化机会总结
-{基于 $APPEALS 缺口 + 差评痛点，用户最在乎但竞品最弱的交叉维度}
+{基于 $APPEALS 缺口 + 差评痛点 + 子品类空白，用户最在乎但竞品最弱的交叉维度}

package/.claude/skills/scout/template/product/market/MARKET.md

@@ -15,11 +15,17 @@
 - BSR 分布:
 - 季节性:
 
+## 子品类分布
+
+| 子品类 | 产品数 | 价格区间 | 头部评论数 | 增长信号 | 竞争度 |
+|--------|--------|---------|-----------|---------|--------|
+
 ## 竞争格局
 - 竞品总数:
 - 头部品牌:
-- 平均评论数:
-- 品牌集中度:
+- 品牌集中度 (CR3/CR5):
+- 卖家国籍分布:
+- FBA/FBM 占比:
 
 ## SPAN 初步评分
 - 市场吸引力: /5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.9.36",
+  "version": "0.9.38",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",