@optima-chat/optima-agent 0.9.37 → 0.9.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,150 +9,188 @@
9
9
  - 新建研究项目时自动进入
10
10
  - RESEARCH.md 当前阶段 = 概念
11
11
 
12
- ## 执行步骤
12
+ ## 流程总览
13
+
14
+ ```
15
+ 第一步:数据采集(步骤 1-4)
16
+
17
+ 第二步:数据完整性检查(必须全部通过才能继续)
18
+
19
+ 第三步:数据分析(步骤 5-7)
20
+
21
+ 第四步:CDCP Gate 评审
22
+ ```
23
+
24
+ **绝对不能跳过数据完整性检查直接做分析。数据不完整的分析是误导性的。**
25
+
26
+ ---
27
+
28
+ ## 第一步:数据采集
13
29
 
14
30
  ### 1. 趋势扫描
15
31
 
16
32
  **目的**:从 Amazon 站外发现热度信号
17
33
 
18
- **具体命令**:
34
+ **必须执行**:
19
35
  - `scout tiktok search-videos "关键词"` 或 `scout tiktok shop-search "关键词"`
20
36
  - `scout reddit trends "关键词"` 或 `scout reddit search "关键词"`
21
- - `scout twitter trends "关键词"` 或 `scout twitter search "关键词"`
22
- - Web Search(补充搜索趋势、新闻报道等)
23
-
24
- **分析要点**:
25
- - 讨论量增长趋势
26
- - 未满足需求(用户抱怨、求推荐)
27
- - 竞品投诉(质量差、功能缺失)
28
- - KOL 推荐(达人带货、测评视频)
29
37
 
30
- **落盘位置**:`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`
31
-
32
- **完成标准**:至少查询 2 个平台,有明确热度信号(或确认无热度)
38
+ **可选补充**:
39
+ - `scout twitter trends "关键词"`
40
+ - `scout instagram reels "关键词"`
41
+ - Web Search 行业报告和新闻
33
42
 
34
- **跨平台发现→验证链路:**
43
+ **跨平台发现→验证链路**:
35
44
  - TikTok/Instagram 发现热度 → `scout search` 验证 Amazon 需求 → `scout supplier-search` 确认成本
36
45
  - Shein/Temu 发现低价爆品 → `scout search` 对比 Amazon 定价 → 判断品牌溢价空间
37
46
  - Reddit/Twitter 发现未满足需求 → `scout search` + `scout reviews` 验证痛点普遍性
38
47
 
48
+ **落盘**:`data/social/{date}-{platform}.json` → 更新 `INDEX.md` + `market/MARKET.md`
49
+
50
+ **完成标准**:至少查询 2 个平台,有明确热度信号(或确认无热度)
51
+
39
52
  ---
40
53
 
41
54
  ### 2. Amazon 市场全景扫描
42
55
 
43
56
  **目的**:全面了解市场,不遗漏重要竞品和子品类
44
57
 
45
- **步骤 A — 广度搜索(必须)**:
58
+ **必须执行**:
59
+
60
+ **A. 广度搜索**:
46
61
  - `scout search "主词" --limit 50`(拉满 50 条)
47
- - 至少 2-3 组关键词,每组 50 条,去重后应覆盖 30-100 个不重复 ASIN
48
- - `scout sp keywords-mine "关键词"` 获取精确月搜索量和转化率
62
+ - 至少 2-3 组关键词,每组 50
63
+ - 去重后应覆盖 **30+ 个不重复 ASIN**
64
+
65
+ **B. 精确搜索量**:
66
+ - `scout sp keywords-mine "主关键词"` — 获取精确月搜索量、购买量、转化率、PPC 竞价
67
+ - 对 2-3 个核心关键词都执行
49
68
 
50
- **步骤 B — 竞品全景补充(推荐)**:
51
- - 从搜索结果中选 1 个头部 ASIN,执行 `scout sp competitors <ASIN>` 拉取竞品列表(可获得更多竞品的销量/销额/利润数据)
52
- - 目标:覆盖该品类的 **Top 30-50 个竞品**,避免遗漏大品牌(如 JOYIN、Anker 等在搜索结果中可能排名靠后但实际份额很大)
69
+ **C. 竞品全景补充**:
70
+ - 从搜索结果中选 1 个头部 ASIN,执行 `scout sp competitors <ASIN>` 拉取更多竞品的销量/销额/利润数据
71
+ - 如命令返回无关数据,改用多关键词搜索补充
53
72
 
54
- **步骤 C — 子品类聚类(必须)**:
73
+ **D. 子品类聚类**(关键步骤):
55
74
  - 对搜索到的所有产品按**产品形态/功能/使用场景**做子品类分类
56
- - 不要只分 2-3 大类,要尽可能细分(目标 5-10 个子品类标签)
57
- - 示例:3D打印玩具 → 龙蛋、动物、蛇、齿轮球、螺旋锥、爪刀、手枪、动作人偶、解压感官...
58
- - 每个子品类标注:产品数量、价格区间、头部评论数、增长信号
75
+ - 目标 **5-10 个子品类标签**
76
+ - 每个子品类标注:产品数量、价格区间、头部评论数、增长信号、竞争度
59
77
  - **子品类聚类是发现细分机会的关键步骤,不能跳过**
60
78
 
61
- **分析要点**:
62
- - 市场总容量(产品总数 + 月总销量估算)
63
- - 价格分布(高/中/低档位各占多少)
64
- - 子品类分布(哪个子品类最大?哪个增长最快?哪个竞争最小?)
65
- - 品牌分布(有无大品牌垄断?中国卖家占比?)
66
- - "bought in past month" 频率(需求热度)
67
-
68
- **落盘位置**:`data/searches/{date}-{keyword}.json` → 更新 `INDEX.md` + `market/MARKET.md`
79
+ **落盘**:`data/searches/{date}-{keyword}.json` + `data/sellersprite/{date}-{keyword}-mine.json` → 更新 `INDEX.md` + `market/MARKET.md`
69
80
 
70
81
  **完成标准**:覆盖 30+ 个不重复竞品,识别出 5+ 个子品类并标注各自规模
71
82
 
72
83
  ---
73
84
 
74
- ### 3. 需求验证
85
+ ### 3. 竞争格局数据采集
86
+
87
+ **目的**:量化竞争强度和竞争者构成
88
+
89
+ **必须执行**:
90
+ - `scout sp category "关键词"` — 查类目 nodeIdPath
91
+ - `scout sp brands <nodeIdPath>` — 获取品牌集中度数据(各品牌 ASIN 数、销量份额、销额份额)
92
+ - `scout sp seller-countries <nodeIdPath>` — 获取卖家国籍分布
93
+ - `scout sp seller-types <nodeIdPath>` — 获取 FBA/FBM/Amazon 自营占比
75
94
 
76
- **目的**:用数据确认有真实购买行为
95
+ **落盘**:`data/sellersprite/{date}-brands-{nodeIdPath}.json` 等 → 更新 `INDEX.md` + `market/MARKET.md`
77
96
 
78
- **具体命令/数据源**:
79
- - 搜索结果中的 "bought in past month" 数据
80
- - 可选:`scout keepa product ASIN1,ASIN2 --stats 90`(获取历史销量数据)
97
+ **完成标准**:有品牌集中度(CR3/CR5 量化数据)+ 卖家国籍分布 + FBA 占比
98
+
99
+ ---
81
100
 
82
- **分析要点**:
83
- - 月搜索量估算
84
- - BSR 分布(头部产品 BSR 越低 = 销量越大)
85
- - salesRankDrops(Keepa 销量掉落次数 ≈ 出单次数)
86
- - "bought in past month" 具体数值
87
- - 推荐:`scout sp keywords-mine "关键词"` 的 `searches`(精确月搜索量)和 `purchases`(月购买量)比 BSR drops 估算更直接
101
+ ### 4. 供应端初探
88
102
 
89
- **落盘位置**:更新 `market/MARKET.md` 需求验证部分
103
+ **目的**:粗估成本,判断利润空间是否足够
90
104
 
91
- **完成标准**:有具体月销量估算数据
105
+ **必须执行**:
106
+ - `scout supplier-search "中文关键词" --limit 10` — 获取 1688 参考价
107
+ - 记录:头部供应商价格区间、MOQ、供应商类型
108
+
109
+ **落盘**:`data/suppliers/{date}-{keyword}.json` → 更新 `INDEX.md`
110
+
111
+ **完成标准**:有 1688 参考价(至少 3 家供应商报价)
92
112
 
93
113
  ---
94
114
 
95
- ### 4. 竞争格局
115
+ ## 第二步:数据完整性检查
96
116
 
97
- **目的**:全面判断竞争强度和竞争者构成
117
+ **在做任何分析之前,必须通过以下检查。任何一项未通过 → 补数据,不分析。**
98
118
 
99
- **分析要点**:
100
- - 竞品总数(步骤 2 全景扫描已获得)
101
- - 头部产品评论数(评论数越多 = 护城河越深)
102
- - 品牌分布:
103
- - `scout sp category "关键词"` → `scout sp brands <nodeIdPath>` 获取量化品牌集中度(CR3/CR5、各品牌 ASIN 数/销量份额/销额份额)
104
- - 识别是否有本土大品牌(如 JOYIN、Crayola)占据显著份额
105
- - 卖家构成:
106
- - `scout sp seller-countries <nodeIdPath>` 获取卖家国籍分布(中国卖家占比多少?有无本土卖家壁垒?)
107
- - `scout sp seller-types <nodeIdPath>` 获取 FBA/FBM/Amazon 自营占比
108
- - 子品类竞争差异(步骤 2 聚类结果):哪个子品类竞争最激烈?哪个最空白?
109
- - 参考 `metrics.md` 竞争指标表
119
+ ```
120
+ 数据完整性检查清单:
121
+
122
+ 搜索覆盖度:INDEX.md 中不重复 ASIN 数量 ≥ 30?
123
+ 子品类聚类:MARKET.md 子品类分布表 5 行?
124
+ □ 精确搜索量:有 scout sp keywords-mine 数据(searches + purchases + bid)?
125
+ 品牌集中度:有 scout sp brands 数据(CR3/CR5 + 份额)?
126
+ 卖家国籍:有 scout sp seller-countries 数据?
127
+ 供应端成本:有 1688 供应商报价(≥ 3 家)?
128
+ □ 卖家类型:有 scout sp seller-types 数据(FBA/FBM 占比)?
129
+ 趋势信号:有至少 2 个社交平台数据?
130
+ □ 原始 JSON 落盘:data/ 目录文件数 ≥ 命令执行数?(每次命令都存了 JSON?)
131
+ □ INDEX.md 一致:INDEX.md 中列出的文件在 data/ 目录中都存在?
132
+ ```
110
133
 
111
- **落盘位置**:更新 `market/MARKET.md` 竞争格局部分
134
+ **如果有未通过的项,告知用户缺什么,补齐后重新检查。**
112
135
 
113
- **完成标准**:知道竞品总数、品牌集中度(量化)、卖家国籍分布、各子品类竞争强度
136
+ **输出格式**:
137
+ ```
138
+ 📋 数据完整性检查
139
+ ✅ 搜索覆盖度:42 个不重复 ASIN(≥ 30)
140
+ ✅ 子品类聚类:7 个子品类(≥ 5)
141
+ ✅ 精确搜索量:3 组关键词已有数据
142
+ ❌ 品牌集中度:未采集 → 需要执行 scout sp brands
143
+ ❌ 卖家国籍:未采集 → 需要执行 scout sp seller-countries
144
+ ✅ 供应端成本:5 家供应商报价
145
+ ✅ 趋势信号:TikTok + Reddit
146
+ ✅ 原始 JSON:12/12 已落盘
147
+ ✅ INDEX.md 一致
148
+
149
+ 结论:2 项未通过,需要补充品牌集中度和卖家国籍数据。
150
+ ```
114
151
 
115
152
  ---
116
153
 
154
+ ## 第三步:数据分析
155
+
156
+ **只有数据完整性检查全部通过后,才进入分析阶段。**
157
+
117
158
  ### 5. SPAN 初步定位
118
159
 
119
160
  **目的**:战略定位评估
120
161
 
121
162
  **方法**:
122
163
  - 参考 `analysis-framework.md` SPAN 评分标准
123
- - SPAN 是一个 2×2 矩阵工具,两个轴:
124
- - Y 轴:市场吸引力(1-5 分,含市场规模、增长趋势、利润潜力、战略价值)
125
- - X 轴:竞争地位(1-5 分,含差异化能力、资金匹配度、供应链能力、进入壁垒)
126
- - 阈值:≥3.5 为"高/强",<3.5 为"低/弱"
127
-
128
- **补充数据来源**:
129
- - 市场规模维度:可用 `scout sp keywords-mine` 的 searches 精确验证月搜索量,替代 BSR drops 估算
130
- - 竞争地位维度:可用 `scout sp brands` 的品牌份额数据辅助判断品牌垄断程度
131
-
132
- **注意**:概念阶段是初步评估,部分维度可以粗略打分,后续阶段再精确
133
-
134
- **落盘位置**:更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
135
-
136
- **完成标准**:两个维度都有评分
164
+ - Y 轴:市场吸引力(1-5 分)
165
+ - 市场规模:用 `scout sp keywords-mine` 的 searches 精确验证
166
+ - 增长趋势:社交媒体热度 + 搜索结果中新品比例
167
+ - 利润潜力:1688 成本 vs Amazon 售价
168
+ - 战略价值:品类协同、复购潜力
169
+ - X 轴:竞争地位(1-5 分)
170
+ - 差异化能力:子品类聚类中的空白机会
171
+ - 资金匹配度:对照 PROFILE.md
172
+ - 供应链能力:1688 供应商数量和质量
173
+ - 进入壁垒:用 `scout sp brands` 的品牌份额数据判断
174
+
175
+ **落盘**:更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
137
176
 
138
177
  ---
139
178
 
140
179
  ### 6. 初步利润估算
141
180
 
142
- **目的**:粗算利润空间,判断是否值得做
181
+ **目的**:粗算利润空间
143
182
 
144
183
  **方法**:
145
184
  - Amazon 均价(从搜索结果取中位数)
146
- - 1688 参考价(可选命令:`scout supplier-search "中文关键词" --limit 5`)
185
+ - 1688 参考价(步骤 4 已采集)
147
186
  - FBA 费估算(按品类/尺寸估算)
148
- - 粗略毛利 = 售价 - 1688参考价 - FBA费 - 平台佣金(概念阶段只算毛利,计划阶段用 FAN 模型精算净利率)
149
- - 可选:`scout sp keywords-mine "关键词"` `bid/bidMin/bidMax` 可以估算 PPC 广告成本,使利润估算更准确
150
-
151
- **对照**:`PROFILE.md` 中的最低毛利率要求。如果 PROFILE 未填写该阈值,提示用户确认:"你的最低可接受毛利率是多少?(默认 50%)"
187
+ - PPC 成本估算:用 `scout sp keywords-mine` `bid` 数据
188
+ - 毛利 = 售价 - COGS - FBA
189
+ - 粗略净利 = 毛利 - PPC 估算 - 退货估算
152
190
 
153
- **落盘位置**:记录在 `RESEARCH.md` 关键发现中
191
+ **对照**:`PROFILE.md` 中的最低毛利率和最低净利率。如果 PROFILE 未填写,必须让用户确认。
154
192
 
155
- **完成标准**:有售价 + 1688 参考价 + FBA 费估算
193
+ **落盘**:记录在 `RESEARCH.md` 关键发现中
156
194
 
157
195
  ---
158
196
 
@@ -161,32 +199,27 @@
161
199
  **目的**:排除法律风险
162
200
 
163
201
  **方法**:
164
- - Web Search 查询:
165
- - 商标注册情况(USPTO、WIPO)
166
- - 外观专利(Design Patent)
167
- - 品类认证要求(FDA、FCC、UL 等)
168
- - Amazon 品类限制(Gated Category)
169
- - 检查是否有已知侵权风险
202
+ - Web Search 查询:商标(USPTO/WIPO)、外观专利、品类认证(FDA/FCC/UL/CPSIA)、Amazon 品类限制
170
203
 
171
- **落盘位置**:记录在 `RESEARCH.md` 关键发现中(如有风险则同时记入风险清单)
172
-
173
- **完成标准**:确认无明显风险(或标注已知风险供后续深入调查)
204
+ **落盘**:记录在 `RESEARCH.md` 关键发现中(如有风险则同时记入风险清单)
174
205
 
175
206
  ---
176
207
 
177
- ## CDCP Gate 评审
208
+ ## 第四步:CDCP Gate 评审
178
209
 
179
210
  ### 触发条件
180
211
 
181
- 7 checklist 项全部完成。
212
+ 1. 步骤 1-4 数据采集完成
213
+ 2. 数据完整性检查全部通过
214
+ 3. 步骤 5-7 分析完成
182
215
 
183
216
  ### 执行方式
184
217
 
185
218
  1. 读取 `analysis-framework.md` 的 CDCP 标准
186
219
  2. 逐一回答 5 个核心问题(引用数据支撑):
187
- - 市场存在吗?(需求验证数据)
188
- - 能赚钱吗?(利润估算)
189
- - 竞争打得过吗?(竞争格局分析)
220
+ - 市场存在吗?(精确搜索量 + 月购买量)
221
+ - 能赚钱吗?(利润估算,含 PPC 成本)
222
+ - 竞争打得过吗?(品牌集中度 + 卖家国籍 + 子品类空白)
190
223
  - 法律风险可控吗?(IP/合规初筛结果)
191
224
  - SPAN 可接受吗?(SPAN 评分)
192
225
  3. 给出 **Go / Kill / Redirect** 建议
@@ -200,13 +233,15 @@
200
233
  ```
201
234
  ## CDCP Gate 评审结果
202
235
 
236
+ ### 数据完整性:✅ 全部通过(10/10)
237
+
203
238
  ### 核心问题
204
239
 
205
240
  | # | 问题 | 结论 | 依据 |
206
241
  |---|------|------|------|
207
- | 1 | 市场存在? | ✅/❌ | [具体数据:月销量、搜索量等] |
208
- | 2 | 能赚钱? | ✅/❌ | [毛利率 XX%,满足/不满足最低毛利率要求] |
209
- | 3 | 竞争打得过? | ✅/❌ | [头部评论数、品牌集中度等] |
242
+ | 1 | 市场存在? | ✅/❌ | [精确搜索量 XX/月,购买量 XX/月,转化率 XX%] |
243
+ | 2 | 能赚钱? | ✅/❌ | [毛利率 XX%,估算净利率 XX%(含 PPC $XX)] |
244
+ | 3 | 竞争打得过? | ✅/❌ | [品牌 CR3=XX%,XX% 中国卖家,子品类 XX 竞争空白] |
210
245
  | 4 | 法律风险? | ✅/❌ | [专利/商标/认证情况] |
211
246
  | 5 | SPAN 可接受? | ✅/❌ | [市场吸引力: X/5, 竞争地位: X/5, 象限: 投资/选择性投入/收割/退出] |
212
247
 
@@ -225,7 +260,7 @@
225
260
  ### 各决策结果的具体操作
226
261
 
227
262
  **Go:**
228
- 1. **生成产品立项书**,保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含:市场概况、SPAN 定位、竞争格局、初步利润估算、机会与风险、Go 建议
263
+ 1. **生成产品立项书**,保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含:市场概况(含子品类分布)、SPAN 定位、竞争格局(含品牌集中度和卖家国籍)、初步利润估算(含 PPC)、机会与风险、Go 建议
229
264
  2. 更新 RESEARCH.md 当前阶段 → 计划
230
265
  3. 更新 RESEARCH.md 决策记录
231
266
  4. 更新 OVERVIEW.md 阶段列
@@ -242,7 +277,7 @@
242
277
  **Redirect:**
243
278
  1. 更新 RESEARCH.md 决策记录(记录调整原因和新方向)
244
279
  2. 根据调整幅度决定:
245
- - **小调整**(如从"无线耳机"缩窄到"开放式耳机"):修改当前项目的研究目标,重置概念阶段 checklist 中受影响的项(如竞争格局、SPAN),重新执行
280
+ - **小调整**(如从"无线耳机"缩窄到"开放式耳机"):修改当前项目的研究目标,重置概念阶段 checklist 中受影响的项,重新执行
246
281
  - **大调整**(方向完全不同):归档当前项目(No-Go),新建项目重新开始
247
282
  3. 无论哪种,保留已有数据不删除(可能在新方向中有参考价值)
248
283
 
@@ -252,42 +287,43 @@
252
287
 
253
288
  **用户**:"我想开店卖钛合金杯子,你觉得合适吗?"
254
289
 
255
- **步骤 1-2:趋势扫描 + Amazon 搜索**
290
+ **第一步:数据采集**
256
291
 
257
- 立即执行:
258
- - `scout search "titanium cup" --limit 15`
259
- - `scout search "titanium mug" --limit 15`
292
+ 立即执行数据采集(不做分析,只收集):
293
+ ```bash
294
+ # 趋势
295
+ scout tiktok search-videos "titanium cup"
296
+ scout reddit trends "titanium cup"
260
297
 
261
- 分享发现:
262
- > "市场有 50+ 竞品,价格 $15-90,主要在 $20-30 区间。头部产品(TOAKS)月销约 200 件,BSR #530。两个方向:低价位($15-25)竞争激烈,高端保温款($60-90)产品很少。你更倾向哪个价位?"
298
+ # 广度搜索
299
+ scout search "titanium cup" --limit 50
300
+ scout search "titanium mug" --limit 50
301
+ scout search "titanium tumbler" --limit 50
263
302
 
264
- **步骤 3-4:用户回复后深入**
303
+ # 精确搜索量
304
+ scout sp keywords-mine "titanium cup"
305
+ scout sp keywords-mine "titanium mug"
265
306
 
266
- 用户:"中高端的,质量好的"
307
+ # 竞争格局
308
+ scout sp category "titanium cup"
309
+ scout sp brands <nodeIdPath>
310
+ scout sp seller-countries <nodeIdPath>
311
+ scout sp seller-types <nodeIdPath>
267
312
 
268
- 执行:`scout product B0CTKWJDXX`、`scout product B0DNCMN3NX`、`scout product B083NLR6BF`
269
-
270
- 分享:
271
- > "TOAKS 中端爆款 BSR #530,月销 250 件,87% 五星。用户最爱:超轻、品质好、无金属味。主要抱怨:散热快(无保温)。KOYASU 高端保温 $89.99,评论少但 4.8 分。保温款市场几乎空白!"
272
-
273
- **步骤 5:Keepa 历史验证**
274
-
275
- 执行:`scout keepa product B0CTKWJDXX,B0DNCMN3NX,B083NLR6BF --stats 180`
313
+ # 供应端
314
+ scout supplier-search "钛合金杯子" --limit 10
315
+ ```
276
316
 
277
- 分享:
278
- > "Keepa 数据显示:TOAKS 的 BSR 过去 6 个月从 #2000 降到 #530,市场在增长。卖家数从 3 增到 8,竞争在加剧但还不激烈。价格稳定在 $25-28,无价格战。保温款 KOYASU BSR 波动大但整体下降,刚起步有潜力。"
317
+ 每个命令执行后立即落盘(JSON + INDEX.md)。
279
318
 
280
- **步骤 6:供应商和成本**
319
+ **第二步:完整性检查**
281
320
 
282
- 用户:"好的,你看看成本"
321
+ > "📋 数据完整性检查:9/9 全部通过。可以开始分析了。"
283
322
 
284
- 执行:
285
- - `scout search "titanium tumbler" --limit 10`
286
- - `scout supplier-search "钛合金保温杯"`
323
+ **第三步:分析**
287
324
 
288
- 分享:
289
- > "批发价区间 ¥180-450(约 $25-65),起订量 50-100 个。头部供应商:8 年工厂,¥280 批发价。**利润分析**:Amazon 售价 $70-90,1688 成本 ¥280(≈$40),运费+FBA 约 $15,总成本约 $55,毛利率 25-40%。"
325
+ 基于完整数据做 SPAN 评分、利润估算、IP 检查。
290
326
 
291
- **步骤 7:建议**
327
+ **第四步:CDCP Gate 评审**
292
328
 
293
- > "概念阶段数据收集完毕。要不要立项做正式的 IPD 分析?我可以帮你做 SPAN 定位、$APPEALS 竞品评分和 FAN 财务模型。"
329
+ 逐项回答 5 个核心问题,给出 Go/Kill/Redirect 建议。
@@ -205,11 +205,33 @@
205
205
 
206
206
  **完成标准**:主要风险识别,每个有应对方案
207
207
 
208
+ ## 数据完整性检查
209
+
210
+ **在 PDCP Gate 评审之前,必须通过以下检查。任何一项未通过 → 补数据,不评审。**
211
+
212
+ ```
213
+ 计划阶段数据完整性检查清单:
214
+
215
+ □ 竞品深度:5-8 个竞品有完整 product detail?
216
+ □ 流量关键词:5-8 个竞品有 scout sp keywords 数据?
217
+ □ 历史销量:5-8 个竞品有 scout sp predict 14 个月数据?
218
+ □ 季节性分析:COMPETITORS.md 季节性分析表已填写?
219
+ □ Listing 能力矩阵:COMPETITORS.md 能力矩阵表已填写?
220
+ □ $APPEALS 评分:≥ 3 个竞品完成 8 维度打分?
221
+ □ 差评分析:≥ 30 条差评已聚类?
222
+ □ Keepa 趋势:有 180 天 BSR 趋势 + 生命周期判断?
223
+ □ FAN 模型:单元经济 + 4 场景分析完整?(含真实 PPC 竞价)
224
+ □ 供应商:≥ 1 家可行供应商?
225
+ □ 差异化策略:COMPETITORS.md 差异化机会总结已填写?
226
+ □ 风险清单:主要风险已识别且有应对方案?
227
+ □ 原始 JSON 落盘:所有命令结果已存到 data/?
228
+ ```
229
+
208
230
  ## PDCP Gate 评审
209
231
 
210
232
  ### 触发条件
211
233
 
212
- 8 项执行步骤全部完成。
234
+ 数据完整性检查全部通过。
213
235
 
214
236
  ### 评审问题(参考 `analysis-framework.md` PDCP 标准)
215
237
 
@@ -23,7 +23,9 @@
23
23
  - [ ] 竞争格局(品牌集中度、卖家国籍分布、各子品类竞争强度)
24
24
  - [ ] SPAN 初步定位(市场吸引力 + 竞争地位)
25
25
  - [ ] 初步利润估算(毛利率 > PROFILE 最低毛利率?)
26
+ - [ ] 供应端初探(1688 参考价,≥3 家供应商报价)
26
27
  - [ ] IP/合规初筛(商标、专利、认证要求)
28
+ - [ ] **数据完整性检查通过**(10 项全部通过)
27
29
  - **CDCP Gate**: 市场够大?利润够高?竞争可打?无 IP 风险?
28
30
 
29
31
  ### 计划阶段(商业计划书)
@@ -36,6 +38,7 @@
36
38
  - [ ] FAN 财务分析(单元经济、盈亏平衡、场景分析、回本周期)
37
39
  - [ ] 供应商初步接触(3-5 家询价、MOQ、交期)
38
40
  - [ ] 风险评估(竞争加剧、价格战、季节性、合规变化)
41
+ - [ ] **数据完整性检查通过**(13 项全部通过)
39
42
  - **PDCP Gate**: 有明确差异化?供应商可行?商业计划书成立?
40
43
 
41
44
  ### 开发阶段(产品实现)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optima-chat/optima-agent",
3
- "version": "0.9.37",
3
+ "version": "0.9.38",
4
4
  "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",