# 概念阶段指引

## 目标

验证产品机会是否值得投入更多资源研究。产出产品立项书初版（即完成项目页概念阶段所有 checklist 项）。

## 何时进入此阶段

- 新建研究项目时自动进入
- `wiki/entities/projects/{slug}.md` 当前阶段 = 概念

## 流程总览

每一步完成后都必须运行 `scout project health-check` 确认状态。

```
第一步：数据采集 → scout project health-check
    ↓（health-check 数据行 ❌ → 执行 Ingest）
第二步：Ingest → scout project health-check
    ↓（health-check 数据行 ✅ → 进入分析）
第三步：数据分析（从 KB 查询，不读缓存）
    ↓
第四步：CDCP Gate 评审
```

**每步的完成标志都是 `scout project health-check` 输出 ✅。没有 ✅ 不进入下一步。**

---

## 第一步：数据采集

### 1. 趋势扫描

**目的**：从 Amazon 站外发现热度信号

**必须执行**：
- `scout tiktok search-videos "关键词"` 或 `scout tiktok shop-search "关键词"`
- `scout reddit trends "关键词"` 或 `scout reddit search "关键词"`

**可选补充**：
- `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` 验证痛点普遍性

**完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）。CLI 自动缓存所有 API 响应到 `~/.scout/cache/{project}/`。

---

### 2. Amazon 市场全景扫描

**目的**：全面了解市场，不遗漏重要竞品和子品类

**必须执行**：

**A. 广度搜索**：
- `scout search "主词" --limit 50`（拉满 50 条）
- 至少 2-3 组关键词，每组 50 条
- 去重后应覆盖 **30+ 个不重复 ASIN**

**B. 精确搜索量**：
- `scout sp keywords-mine "主关键词"` — 获取精确月搜索量、购买量、转化率、PPC 竞价
- 对 2-3 个核心关键词都执行

**C. 竞品全景补充**：
- 从搜索结果中选 1 个头部 ASIN，执行 `scout sp competitors <ASIN>` 拉取更多竞品的销量/销额/利润数据
- 如命令返回无关数据，改用多关键词搜索补充

**D. 子品类聚类**（关键步骤）：
- 对搜索到的所有产品按**产品形态/功能/使用场景**做子品类分类
- 目标 **5-10 个子品类标签**
- 每个子品类标注：产品数量、价格区间、头部评论数、增长信号、竞争度
- **子品类聚类是发现细分机会的关键步骤，不能跳过**

**完成标准**：覆盖 30+ 个不重复竞品，识别出 5+ 个子品类并标注各自规模。CLI 自动缓存所有 API 响应。

---

### 3. 竞争格局数据采集

**目的**：量化竞争强度和竞争者构成

**必须执行**：
- `scout sp category "关键词"` — 查类目 nodeIdPath
- `scout sp brands <nodeIdPath>` — 获取品牌集中度数据（各品牌 ASIN 数、销量份额、销额份额）
- `scout sp seller-countries <nodeIdPath>` — 获取卖家国籍分布
- `scout sp seller-types <nodeIdPath>` — 获取 FBA/FBM/Amazon 自营占比

**完成标准**：有品牌集中度（CR3/CR5 量化数据）+ 卖家国籍分布 + FBA 占比。CLI 自动缓存所有 API 响应。

---

### 4. 供应端初探

**目的**：粗估成本，判断利润空间是否足够

**必须执行**：
- `scout supplier-search "中文关键词" --limit 10` — 获取 1688 参考价
- 记录：头部供应商价格区间、MOQ、供应商类型

**完成标准**：有 1688 参考价（至少 3 家供应商报价）。CLI 自动缓存所有 API 响应。

### 数据采集完成 → 运行 health-check

数据采集完成后，立即运行：
```bash
scout project health-check
```

看输出的 **数据** 行：
- `cache N → raw 0 → sources 0` → 需要执行 Ingest（见下方）
- `cache N → raw N → sources N` → 数据已就绪，跳到第三步

---

## 第二步：Ingest

将缓存数据收录到 KB。只有 health-check 数据行显示 ❌ 时才需要执行。

1. `cp ~/.scout/cache/{project}/*.json ~/kb/product-research/raw/`
2. 执行 `Skill("ingesting-sources")` 对每个 raw/ 文件创建 source 页
3. 执行 `Skill("updating-related-pages")` 更新 entity/overview 页
4. 再次运行 `scout project health-check` 确认数据行显示 ✅

---

## 第三步：数据分析

**前提：`scout project health-check` 数据行已显示 ✅。**

**所有分析数据必须通过 `Skill("querying-the-wiki")` 从 KB 查询，禁止直接读 `~/.scout/cache/` 中的 JSON 文件。**

### 5. SPAN 初步定位

**目的**：战略定位评估

**方法**：
- 通过 `Skill("querying-the-wiki")` 查询：子品类分布、精确搜索量、品牌集中度、卖家画像
- 参考 `analysis-framework.md` SPAN 评分标准
- Y 轴：市场吸引力（1-5 分）— 市场规模、增长趋势、利润潜力、战略价值
- X 轴：竞争地位（1-5 分）— 差异化能力、资金匹配度、供应链能力、进入壁垒

**记录**：更新 `wiki/entities/projects/{slug}.md` SPAN 定位

---

### 6. 初步利润估算

**目的**：粗算利润空间

**方法**：
- 通过 `Skill("querying-the-wiki")` 查询：Amazon 均价、1688 参考价、PPC 竞价数据、卖家画像的利润阈值
- 毛利 = 售价 - COGS - FBA 费
- 粗略净利 = 毛利 - PPC 估算 - 退货估算

**记录**：更新 `wiki/entities/projects/{slug}.md` 关键发现

---

### 7. IP/合规初筛

**目的**：排除法律风险

**方法**：
- Web Search 查询：商标（USPTO/WIPO）、外观专利、品类认证（FDA/FCC/UL/CPSIA）、Amazon 品类限制

**记录**：更新 `wiki/entities/projects/{slug}.md` 关键发现（如有风险则同时记入风险清单）

---

## 第四步：CDCP Gate 评审

### 触发条件

1. 步骤 1-4 数据采集完成
2. 数据完整性检查全部通过
3. 步骤 5-7 分析完成

### 执行方式

1. 读取 `analysis-framework.md` 的 CDCP 标准
2. 逐一回答 5 个核心问题（引用数据支撑）：
   - 市场存在吗？（精确搜索量 + 月购买量）
   - 能赚钱吗？（利润估算，含 PPC 成本）
   - 竞争打得过吗？（品牌集中度 + 卖家国籍 + 子品类空白）
   - 法律风险可控吗？（IP/合规初筛结果）
   - SPAN 可接受吗？（SPAN 评分）
3. 给出 **Go / Kill / Redirect** 建议
4. 等待用户确认决策
5. 确认后更新：
   - `wiki/entities/projects/{slug}.md`（阶段 → 计划，记录决策）
   - `index.md`（状态更新）

### 评审输出格式模板

```
## CDCP Gate 评审结果

### 数据完整性：✅ 全部通过（10/10）

### 核心问题

| # | 问题 | 结论 | 依据 |
|---|------|------|------|
| 1 | 市场存在？ | ✅/❌ | [精确搜索量 XX/月，购买量 XX/月，转化率 XX%] |
| 2 | 能赚钱？ | ✅/❌ | [毛利率 XX%，估算净利率 XX%（含 PPC $XX）] |
| 3 | 竞争打得过？ | ✅/❌ | [品牌 CR3=XX%，XX% 中国卖家，子品类 XX 竞争空白] |
| 4 | 法律风险？ | ✅/❌ | [专利/商标/认证情况] |
| 5 | SPAN 可接受？ | ✅/❌ | [市场吸引力: X/5, 竞争地位: X/5, 象限: 投资/选择性投入/收割/退出] |

### 建议

**决策：Go / Kill / Redirect**

理由：[1-2 句总结]

### 下一步
- [如果 Go：进入计划阶段需要做什么]
- [如果 Kill：归档原因]
- [如果 Redirect：建议调整方向]
```

### 各决策结果的具体操作

**Go：**
1. Read `references/report-style.md` 加载报告风格指南
2. **生成产品立项书**，保存到 `wiki/analyses/{slug}-charter.md`，按 report-style.md 的"产品立项书章节结构"写作
3. 验证：`ls ~/kb/product-research/wiki/analyses/{slug}-charter.md` 确认文件已生成
4. 更新 `wiki/entities/projects/{slug}.md` 当前阶段 → 计划
5. 更新 `wiki/entities/projects/{slug}.md` 决策记录
6. 更新 `index.md` 阶段列
7. 更新 `wiki/overview/roadmap.md`（该产品状态 → 已通过概念评审）
8. 加载 planning.md 开始计划阶段

**Kill：**
1. 更新 `wiki/entities/projects/{slug}.md` 状态 → 已决策(No-Go)
2. 更新 `wiki/entities/projects/{slug}.md` 决策记录（记录放弃原因）
3. 更新 `index.md`：从活跃移到已完结
4. 更新 `wiki/overview/roadmap.md`（该产品状态 → 已放弃）
5. 提示更新 `wiki/overview/cbb.md`（即使失败也可能积累了有用信息）

**Redirect：**
1. 更新 `wiki/entities/projects/{slug}.md` 决策记录（记录调整原因和新方向）
2. 根据调整幅度决定：
   - **小调整**（如从"无线耳机"缩窄到"开放式耳机"）：修改当前项目的研究目标，重置概念阶段 checklist 中受影响的项，重新执行
   - **大调整**（方向完全不同）：归档当前项目(No-Go)，新建项目重新开始
3. 无论哪种，保留已有数据不删除（可能在新方向中有参考价值）

## 完整交互示例

### 示例：研究钛合金杯子

**用户**："我想开店卖钛合金杯子，你觉得合适吗？"

**第一步：数据采集**

立即执行数据采集（不做分析，只收集）：
```bash
# 趋势
scout tiktok search-videos "titanium cup"
scout reddit trends "titanium cup"

# 广度搜索
scout search "titanium cup" --limit 50
scout search "titanium mug" --limit 50
scout search "titanium tumbler" --limit 50

# 精确搜索量
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 supplier-search "钛合金杯子" --limit 10
```

CLI 自动缓存所有 API 响应到 `~/.scout/cache/{project}/`，无需手动落盘。

**第二步：Ingest + 完整性检查**

`cp` 缓存到 raw/ → `Skill("ingesting-sources")` → `Skill("updating-related-pages")` → 完整性检查。

> "📋 数据完整性检查：10/10 全部通过。可以开始分析了。"

**第三步：分析**

通过 `Skill("querying-the-wiki")` 查询 KB 数据，做 SPAN 评分、利润估算、IP 检查。

**第四步：CDCP Gate 评审**

逐项回答 5 个核心问题，给出 Go/Kill/Redirect 建议。