@optima-chat/optima-agent 0.9.27 → 0.9.28

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.
Files changed (8) hide show
  1. package/.claude/skills/scout/SKILL.md +37 -26
  2. package/.claude/skills/scout/references/concept.md +2 -2
  3. package/.claude/skills/scout/references/cross-project.md +1 -1
  4. package/.claude/skills/scout/references/planning.md +4 -4
  5. package/.claude/skills/scout/references/qualification.md +1 -1
  6. package/.claude/skills/scout/template/product/INDEX.md +27 -0
  7. package/.claude/skills/scout/template/product/data/.gitkeep +0 -0
  8. package/package.json +1 -1
package/.claude/skills/scout/SKILL.md CHANGED
@@ -86,38 +86,49 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
86
86
 
87
87
  ### 落盘映射
88
88
 
89
- | 命令 | JSON 文件 | 更新的活文档 |
90
- |------|----------|------------|
91
- | `scout search` | market/searches.json | market/MARKET.md |
92
- | `scout tiktok *` | market/tiktok.json | market/MARKET.md |
93
- | `scout reddit *` | market/reddit.json | market/MARKET.md |
94
- | `scout twitter *` | market/twitter.json | market/MARKET.md |
95
- | `scout instagram *` | market/instagram.json | market/MARKET.md |
96
- | `scout douyin *` | market/douyin.json | market/MARKET.md |
97
- | `scout xhs *` | market/xhs.json | market/MARKET.md |
98
- | `scout shein-search` | market/shein.json | market/MARKET.md |
99
- | `scout temu-search` | market/temu.json | market/MARKET.md |
100
- | `scout taobao *` | market/taobao.json | market/MARKET.md |
101
- | Web Search | market/web-research.json | market/MARKET.md |
102
- | `scout product` | competitors/{ASIN}.json | competitors/COMPETITORS.md |
103
- | `scout reviews` | reviews/{ASIN}-reviews.json | reviews/PAIN-POINTS.md |
104
- | `scout keepa product` | trends/keepa-data.json | trends/TRENDS.md |
105
- | `scout supplier-search` | suppliers/suppliers.json | suppliers/SUPPLIERS.md |
106
- | `scout supplier-search-image` | suppliers/suppliers.json | suppliers/SUPPLIERS.md |
107
-
108
- **注意**：所有路径相对于项目目录 `~/products/{slug}/`。不要在其他目录创建文件。
89
+ 原始数据统一存放在 `data/` 目录，活文档在各子目录。
90
+
91
+ | 命令 | 原始数据（data/ 下） | 更新的活文档 | 更新 INDEX.md |
92
+ |------|-------------------|------------|-------------|
93
+ | `scout search` | data/searches/{date}-{keyword}.json | market/MARKET.md | ✅ |
94
+ | `scout tiktok *` | data/social/{date}-tiktok.json | market/MARKET.md | ✅ |
95
+ | `scout reddit *` | data/social/{date}-reddit.json | market/MARKET.md | ✅ |
96
+ | `scout twitter *` | data/social/{date}-twitter.json | market/MARKET.md | ✅ |
97
+ | `scout instagram *` | data/social/{date}-instagram.json | market/MARKET.md | ✅ |
98
+ | `scout douyin *` | data/social/{date}-douyin.json | market/MARKET.md | ✅ |
99
+ | `scout xhs *` | data/social/{date}-xhs.json | market/MARKET.md | ✅ |
100
+ | `scout shein-search` | data/searches/{date}-shein.json | market/MARKET.md | ✅ |
101
+ | `scout temu-search` | data/searches/{date}-temu.json | market/MARKET.md | ✅ |
102
+ | `scout taobao *` | data/searches/{date}-taobao.json | market/MARKET.md | ✅ |
103
+ | Web Search | data/social/{date}-web.json | market/MARKET.md | ✅ |
104
+ | `scout product` | data/products/{ASIN}.json | competitors/COMPETITORS.md | ✅ |
105
+ | `scout reviews` | data/reviews/{ASIN}-{star}.json | reviews/PAIN-POINTS.md | ✅ |
106
+ | `scout keepa product` | data/keepa/{date}-batch.json | trends/TRENDS.md | ✅ |
107
+ | `scout supplier-search` | data/suppliers/{date}-keyword.json | suppliers/SUPPLIERS.md | ✅ |
108
+ | `scout supplier-search-image` | data/suppliers/{date}-image.json | suppliers/SUPPLIERS.md | ✅ |
109
+
110
+ **文件命名规则**：
111
+ - `{date}` = YYYY-MM-DD（如 2026-05-05）
112
+ - `{keyword}` = 搜索关键词的 slug（如 open-ear-earbuds）
113
+ - `{ASIN}` = 10 位 Amazon 产品 ID
114
+ - `{star}` = 评论星级筛选（如 one-star、all-stars）
115
+ - 同一 ASIN 多次拉取时覆盖（产品数据取最新值）；搜索类数据带日期不覆盖
116
+
117
+ **注意**：所有路径相对于项目目录 `~/products/{slug}/`。
109
118
 
110
119
  ### 落盘执行顺序（必须严格遵守）
111
120
 
112
- 每次执行 `scout` 命令后，**必须按以下顺序操作**：
121
+ 每次执行 `scout` 命令后，**必须按以下三步操作**：
113
122
 
114
- 1. **先存 JSON** — 将命令的完整原始输出保存到对应 JSON 文件。使用 `--format json` 获取结构化数据，重定向或写入到文件。如果文件已存在，追加到数组中（带时间戳）。
115
- 2. **再写活文档** — 基于数据分析后更新对应的 Markdown 活文档。
123
+ 1. **存原始数据** — 将命令完整输出保存到 `data/` 对应文件。使用 `--format json` 获取结构化数据。
124
+ 2. **更新 INDEX.md** — 在数据索引中添加/更新该条数据的记录（文件路径、时间、关联关系）。
125
+ 3. **更新活文档** — 基于新数据更新对应的 Markdown 活文档。
116
126
 
117
127
  **绝对不能**：
118
- - 只写活文档不存 JSON（原始数据会丢失，无法回溯）
119
- - 只在对话中展示结果不落盘（数据不会持久化）
120
- - 把命令输出摘要当作 JSON 存储（必须是完整的原始返回）
128
+ - 只写活文档不存原始数据（数据丢失，无法回溯和重新分析）
129
+ - 只在对话中展示结果不落盘（下次对话无法使用）
130
+ - 把摘要当作原始数据存储（必须是完整返回）
131
+ - 忘记更新 INDEX.md（agent 下次无法发现已有数据）
121
132
 
122
133
  **JSON 存储示例**：
123
134
  ```bash
package/.claude/skills/scout/references/concept.md CHANGED
@@ -27,7 +27,7 @@
27
27
  - 竞品投诉（质量差、功能缺失）
28
28
  - KOL 推荐（达人带货、测评视频）
29
29
 
30
- **落盘位置**：`market/tiktok.json`、`market/reddit.json`、`market/twitter.json`、`market/web-research.json`
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
31
 
32
32
  **完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）
33
33
 
@@ -53,7 +53,7 @@
53
53
  - "bought in past month" 频率（需求热度）
54
54
  - 品牌重复度（垄断程度）
55
55
 
56
- **落盘位置**：`market/searches.json` → 更新 `market/MARKET.md`
56
+ **落盘位置**：`data/searches/{date}-{keyword}.json` → 更新 `INDEX.md` + `market/MARKET.md`
57
57
 
58
58
  **完成标准**：2-3 组关键词搜索覆盖主要同义词
59
59
 
package/.claude/skills/scout/references/cross-project.md CHANGED
@@ -31,7 +31,7 @@
31
31
 
32
32
  ### 供应商资源复用
33
33
 
34
- 检查各项目 suppliers/suppliers.json：
34
+ 检查各项目 data/suppliers/ 目录：
35
35
  - 同一供应商能否供多个产品
36
36
  - 合并采购的议价空间
37
37
  - 供应商地域风险分散
package/.claude/skills/scout/references/planning.md CHANGED
@@ -32,7 +32,7 @@
32
32
  - A+ 页面有无及质量
33
33
  - 变体布局（颜色/尺寸/套装）
34
34
 
35
- **落盘位置**：`competitors/{ASIN}.json` → 更新 `competitors/COMPETITORS.md`
35
+ **落盘位置**：`data/products/{ASIN}.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
36
36
 
37
37
  **完成标准**：3-5 个竞品有完整数据
38
38
 
@@ -76,7 +76,7 @@
76
76
  - 评估改进可行性（技术难度、成本影响）
77
77
  - 同时分析好评高频词（判断维度权重）
78
78
 
79
- **落盘位置**：`reviews/{ASIN}-reviews.json` → 更新 `reviews/PAIN-POINTS.md`
79
+ **落盘位置**：`data/reviews/{ASIN}-{star}.json` → 更新 `INDEX.md` + `reviews/PAIN-POINTS.md`
80
80
 
81
81
  **完成标准**：≥30 条差评分析，形成 3+ 个痛点聚类
82
82
 
@@ -99,7 +99,7 @@
99
99
  - 成熟期：BSR 平稳 + 评论稳定增长 + 价格竞争加剧
100
100
  - 衰退期：BSR 上升 + 评论增速放缓 + 卖家数减少
101
101
 
102
- **落盘位置**：`trends/keepa-data.json` → 更新 `trends/TRENDS.md`
102
+ **落盘位置**：`data/keepa/{date}-batch.json` → 更新 `INDEX.md` + `trends/TRENDS.md`
103
103
 
104
104
  **完成标准**：有 Keepa 数据，判断了生命周期
105
105
 
@@ -146,7 +146,7 @@
146
146
  - 盈亏平衡点
147
147
  - 回本周期
148
148
 
149
- **落盘位置**：`suppliers/suppliers.json` → 更新 `RESEARCH.md` FAN + `suppliers/SUPPLIERS.md`
149
+ **落盘位置**：`data/suppliers/{date}-keyword.json` → 更新 `INDEX.md` + `RESEARCH.md` FAN + `suppliers/SUPPLIERS.md`
150
150
 
151
151
  **完成标准**：单元经济完整，有场景分析
152
152
 
package/.claude/skills/scout/references/qualification.md CHANGED
@@ -43,7 +43,7 @@
43
43
  - 前 10-20 条评论（`scout reviews MY_ASIN --pages 2`）
44
44
  - 正面是否验证差异化？负面有无预期外问题？
45
45
  - 参考 requirements.md 的"验证"步骤做需求满足度确认
46
- - **落盘位置**：reviews/{MY_ASIN}-reviews.json + 更新 reviews/PAIN-POINTS.md
46
+ - **落盘位置**：`data/reviews/{ASIN}-post-launch.json` → 更新 `INDEX.md` + `reviews/PAIN-POINTS.md`
47
47
 
48
48
  ## ADCP Gate 评审
49
49
 
package/.claude/skills/scout/template/product/INDEX.md ADDED
@@ -0,0 +1,27 @@
1
+ # 数据索引
2
+
3
+ 本文件记录已收集的所有数据，agent 分析前先读此文件了解数据全貌。
4
+
5
+ ## 市场搜索
6
+
7
+ | 关键词 | 时间 | 结果数 | 数据文件 |
8
+ |--------|------|--------|---------|
9
+
10
+ ## 社交/趋势
11
+
12
+ | 平台 | 关键词 | 时间 | 数据文件 |
13
+ |------|--------|------|---------|
14
+
15
+ ## 竞品数据
16
+
17
+ | ASIN | 产品名 | product | reviews | keepa | 上次更新 |
18
+ |------|--------|---------|---------|-------|---------|
19
+
20
+ ## 供应商数据
21
+
22
+ | 搜索方式 | 关键词/图片 | 时间 | 结果数 | 数据文件 |
23
+ |---------|-----------|------|--------|---------|
24
+
25
+ ## 数据关系
26
+
27
+ {记录数据之间的关联，如：哪个供应商对应哪个竞品，哪些 ASIN 来自哪次搜索}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optima-chat/optima-agent",
3
- "version": "0.9.27",
3
+ "version": "0.9.28",
4
4
  "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",