@optima-chat/optima-agent 0.9.27 → 0.9.29
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.
- package/.claude/skills/scout/SKILL.md +46 -28
- package/.claude/skills/scout/references/concept.md +2 -2
- package/.claude/skills/scout/references/cross-project.md +1 -1
- package/.claude/skills/scout/references/planning.md +4 -4
- package/.claude/skills/scout/references/qualification.md +1 -1
- package/.claude/skills/scout/template/product/INDEX.md +27 -0
- package/.claude/skills/scout/template/product/LOGS.md +4 -0
- package/.claude/skills/scout/template/product/data/.gitkeep +0 -0
- package/package.json +1 -1
|
@@ -9,6 +9,7 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
|
|
|
9
9
|
|
|
10
10
|
1. 检查 `~/products/` 是否存在
|
|
11
11
|
- 不存在 → 从 template/user/ 复制 PROFILE.md、OVERVIEW.md、CBB.md、ROADMAP.md 到 `~/products/`
|
|
12
|
+
- 初始化 git 仓库：`cd ~/products && git init && git add -A && git commit -m "init: 初始化产品研究工作区"`
|
|
12
13
|
- **必须询问用户填写 PROFILE.md 的关键字段**（至少：主营市场、目标价位、最低毛利率、最低净利率、单品启动预算）。这些信息直接影响 SPAN 评分和 FAN 判断，缺失会导致分析不准确。用户可以简短回答，agent 帮填入。
|
|
13
14
|
2. 检查 PROFILE.md 是否已填写关键字段
|
|
14
15
|
- 未填写 → 必须询问（不能跳过关键字段：最低毛利率、最低净利率、单品启动预算）
|
|
@@ -17,7 +18,7 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
|
|
|
17
18
|
- 指定了具体产品 → 匹配已有项目（按名称/关键词）或新建
|
|
18
19
|
- 未指定 → 展示当前项目状态，询问继续/新建
|
|
19
20
|
- 要求跨项目分析 → 加载 [cross-project.md](references/cross-project.md)
|
|
20
|
-
5. 进入项目后读取 `~/products/{slug}/RESEARCH.md`
|
|
21
|
+
5. 进入项目后读取 `~/products/{slug}/RESEARCH.md` + `~/products/{slug}/LOGS.md`（了解上次做到哪了）
|
|
21
22
|
6. 根据当前阶段加载对应 reference 文件
|
|
22
23
|
|
|
23
24
|
## 快速研究模式
|
|
@@ -47,7 +48,9 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
|
|
|
47
48
|
3. 在 RESEARCH.md 中填入：产品名称、创建日期、研究目标
|
|
48
49
|
4. 在 OVERVIEW.md 中添加一行到"活跃项目"表
|
|
49
50
|
5. 在 ROADMAP.md 品类机会池中添加该产品（状态=已立项）
|
|
50
|
-
6.
|
|
51
|
+
6. 在 LOGS.md 中记录："立项：{产品名称}"
|
|
52
|
+
7. 检查 CBB.md：是否有可复用的能力模块？如有，告知用户并纳入 SPAN 评分考量
|
|
53
|
+
8. `cd ~/products && git add -A && git commit -m "新建项目: {slug}"`
|
|
51
54
|
|
|
52
55
|
### 切换项目
|
|
53
56
|
|
|
@@ -86,38 +89,53 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
|
|
|
86
89
|
|
|
87
90
|
### 落盘映射
|
|
88
91
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
|
92
|
-
|
|
93
|
-
| `scout
|
|
94
|
-
| `scout
|
|
95
|
-
| `scout
|
|
96
|
-
| `scout
|
|
97
|
-
| `scout
|
|
98
|
-
| `scout
|
|
99
|
-
| `scout
|
|
100
|
-
| `scout
|
|
101
|
-
|
|
|
102
|
-
| `scout
|
|
103
|
-
|
|
|
104
|
-
| `scout
|
|
105
|
-
| `scout
|
|
106
|
-
| `scout
|
|
107
|
-
|
|
108
|
-
|
|
92
|
+
原始数据统一存放在 `data/` 目录，活文档在各子目录。
|
|
93
|
+
|
|
94
|
+
| 命令 | 原始数据（data/ 下） | 更新的活文档 | 更新 INDEX.md |
|
|
95
|
+
|------|-------------------|------------|-------------|
|
|
96
|
+
| `scout search` | data/searches/{date}-{keyword}.json | market/MARKET.md | ✅ |
|
|
97
|
+
| `scout tiktok *` | data/social/{date}-tiktok.json | market/MARKET.md | ✅ |
|
|
98
|
+
| `scout reddit *` | data/social/{date}-reddit.json | market/MARKET.md | ✅ |
|
|
99
|
+
| `scout twitter *` | data/social/{date}-twitter.json | market/MARKET.md | ✅ |
|
|
100
|
+
| `scout instagram *` | data/social/{date}-instagram.json | market/MARKET.md | ✅ |
|
|
101
|
+
| `scout douyin *` | data/social/{date}-douyin.json | market/MARKET.md | ✅ |
|
|
102
|
+
| `scout xhs *` | data/social/{date}-xhs.json | market/MARKET.md | ✅ |
|
|
103
|
+
| `scout shein-search` | data/searches/{date}-shein.json | market/MARKET.md | ✅ |
|
|
104
|
+
| `scout temu-search` | data/searches/{date}-temu.json | market/MARKET.md | ✅ |
|
|
105
|
+
| `scout taobao *` | data/searches/{date}-taobao.json | market/MARKET.md | ✅ |
|
|
106
|
+
| Web Search | data/social/{date}-web.json | market/MARKET.md | ✅ |
|
|
107
|
+
| `scout product` | data/products/{ASIN}.json | competitors/COMPETITORS.md | ✅ |
|
|
108
|
+
| `scout reviews` | data/reviews/{ASIN}-{star}.json | reviews/PAIN-POINTS.md | ✅ |
|
|
109
|
+
| `scout keepa product` | data/keepa/{date}-batch.json | trends/TRENDS.md | ✅ |
|
|
110
|
+
| `scout supplier-search` | data/suppliers/{date}-keyword.json | suppliers/SUPPLIERS.md | ✅ |
|
|
111
|
+
| `scout supplier-search-image` | data/suppliers/{date}-image.json | suppliers/SUPPLIERS.md | ✅ |
|
|
112
|
+
|
|
113
|
+
**文件命名规则**：
|
|
114
|
+
- `{date}` = YYYY-MM-DD（如 2026-05-05）
|
|
115
|
+
- `{keyword}` = 搜索关键词的 slug（如 open-ear-earbuds）
|
|
116
|
+
- `{ASIN}` = 10 位 Amazon 产品 ID
|
|
117
|
+
- `{star}` = 评论星级筛选（如 one-star、all-stars）
|
|
118
|
+
- 同一 ASIN 多次拉取时覆盖（产品数据取最新值）；搜索类数据带日期不覆盖
|
|
119
|
+
|
|
120
|
+
**注意**：所有路径相对于项目目录 `~/products/{slug}/`。
|
|
109
121
|
|
|
110
122
|
### 落盘执行顺序（必须严格遵守）
|
|
111
123
|
|
|
112
|
-
每次执行 `scout`
|
|
124
|
+
每次执行 `scout` 命令后，**必须按以下五步操作**：
|
|
113
125
|
|
|
114
|
-
1.
|
|
115
|
-
2.
|
|
126
|
+
1. **存原始数据** — 将命令完整输出保存到 `data/` 对应文件。使用 `--format json` 获取结构化数据。
|
|
127
|
+
2. **更新 INDEX.md** — 在数据索引中添加/更新该条数据的记录（文件路径、时间、关联关系）。
|
|
128
|
+
3. **更新活文档** — 基于新数据更新对应的 Markdown 活文档。
|
|
129
|
+
4. **追加 LOGS.md** — 在操作日志中记录本次操作（时间 + 做了什么 + 关键发现）。
|
|
130
|
+
5. **git commit** — `cd ~/products && git add -A && git commit -m "{简短描述}"`
|
|
116
131
|
|
|
117
132
|
**绝对不能**：
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
133
|
+
- 只写活文档不存原始数据（数据丢失，无法回溯和重新分析）
|
|
134
|
+
- 只在对话中展示结果不落盘（下次对话无法使用）
|
|
135
|
+
- 把摘要当作原始数据存储（必须是完整返回）
|
|
136
|
+
- 忘记更新 INDEX.md（agent 下次无法发现已有数据）
|
|
137
|
+
- 忘记写 LOGS.md（跨会话上下文会丢失）
|
|
138
|
+
- 忘记 git commit（版本历史会断裂）
|
|
121
139
|
|
|
122
140
|
**JSON 存储示例**：
|
|
123
141
|
```bash
|
|
@@ -27,7 +27,7 @@
|
|
|
27
27
|
- 竞品投诉（质量差、功能缺失）
|
|
28
28
|
- KOL 推荐（达人带货、测评视频）
|
|
29
29
|
|
|
30
|
-
**落盘位置**：`
|
|
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
|
-
**落盘位置**：`
|
|
56
|
+
**落盘位置**：`data/searches/{date}-{keyword}.json` → 更新 `INDEX.md` + `market/MARKET.md`
|
|
57
57
|
|
|
58
58
|
**完成标准**：2-3 组关键词搜索覆盖主要同义词
|
|
59
59
|
|
|
@@ -32,7 +32,7 @@
|
|
|
32
32
|
- A+ 页面有无及质量
|
|
33
33
|
- 变体布局（颜色/尺寸/套装）
|
|
34
34
|
|
|
35
|
-
**落盘位置**：`
|
|
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}-
|
|
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
|
-
**落盘位置**：`
|
|
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/
|
|
149
|
+
**落盘位置**：`data/suppliers/{date}-keyword.json` → 更新 `INDEX.md` + `RESEARCH.md` FAN + `suppliers/SUPPLIERS.md`
|
|
150
150
|
|
|
151
151
|
**完成标准**：单元经济完整，有场景分析
|
|
152
152
|
|
|
@@ -43,7 +43,7 @@
|
|
|
43
43
|
- 前 10-20 条评论（`scout reviews MY_ASIN --pages 2`）
|
|
44
44
|
- 正面是否验证差异化？负面有无预期外问题？
|
|
45
45
|
- 参考 requirements.md 的"验证"步骤做需求满足度确认
|
|
46
|
-
-
|
|
46
|
+
- **落盘位置**：`data/reviews/{ASIN}-post-launch.json` → 更新 `INDEX.md` + `reviews/PAIN-POINTS.md`
|
|
47
47
|
|
|
48
48
|
## ADCP Gate 评审
|
|
49
49
|
|
|
@@ -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 来自哪次搜索}
|
|
File without changes
|