@optima-chat/optima-agent 0.9.38 → 0.9.40

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 (110) hide show
  1. package/.claude/settings.local.json +166 -0
  2. package/.claude/skills/scout/SKILL.md +46 -141
  3. package/.claude/skills/scout/references/analysis-framework.md +4 -4
  4. package/.claude/skills/scout/references/concept.md +49 -46
  5. package/.claude/skills/scout/references/cross-project.md +9 -9
  6. package/.claude/skills/scout/references/development.md +13 -13
  7. package/.claude/skills/scout/references/launch.md +1 -1
  8. package/.claude/skills/scout/references/lifecycle.md +3 -3
  9. package/.claude/skills/scout/references/market-management.md +18 -18
  10. package/.claude/skills/scout/references/planning.md +25 -24
  11. package/.claude/skills/scout/references/qualification.md +11 -11
  12. package/.claude/skills/scout/references/requirements.md +10 -10
  13. package/.claude/skills/scout/template/kb/AGENTS.md +151 -0
  14. package/.claude/skills/scout/template/kb/wiki/entities/projects-template.md +113 -0
  15. package/.claude/skills/scout/template/kb/wiki/entities/seller-profile.md +23 -0
  16. package/.claude/skills/scout/template/kb/wiki/overview/cbb.md +33 -0
  17. package/.claude/skills/scout/template/kb/wiki/overview/competition-template.md +33 -0
  18. package/.claude/skills/scout/template/kb/wiki/overview/market-template.md +32 -0
  19. package/.claude/skills/scout/template/kb/wiki/overview/pain-points-template.md +19 -0
  20. package/.claude/skills/scout/template/kb/wiki/overview/roadmap.md +41 -0
  21. package/.claude/skills/scout/template/kb/wiki/overview/suppliers-template.md +34 -0
  22. package/.claude/skills/scout/template/kb/wiki/overview/trends-template.md +23 -0
  23. package/dist/bin/bi-cli.js +0 -0
  24. package/dist/bin/browser-cli.js +0 -0
  25. package/dist/bin/channels.js +0 -0
  26. package/dist/bin/comfy.d.ts +3 -0
  27. package/dist/bin/comfy.d.ts.map +1 -0
  28. package/dist/bin/comfy.js +3 -0
  29. package/dist/bin/comfy.js.map +1 -0
  30. package/dist/bin/commerce.js +0 -0
  31. package/dist/bin/gen.js +0 -0
  32. package/dist/bin/google-ads.js +0 -0
  33. package/dist/bin/growth.d.ts +3 -0
  34. package/dist/bin/growth.d.ts.map +1 -0
  35. package/dist/bin/growth.js +3 -0
  36. package/dist/bin/growth.js.map +1 -0
  37. package/dist/bin/kb-skills.js +0 -0
  38. package/dist/bin/logistics.js +0 -0
  39. package/dist/bin/optima.js +0 -0
  40. package/dist/bin/scout.js +0 -0
  41. package/dist/bin/sentinel.js +0 -0
  42. package/dist/bin/shopify.js +0 -0
  43. package/dist/src/hooks-loader.d.ts +6 -0
  44. package/dist/src/hooks-loader.d.ts.map +1 -0
  45. package/dist/src/hooks-loader.js +215 -0
  46. package/dist/src/hooks-loader.js.map +1 -0
  47. package/dist/src/ui/App.d.ts +6 -0
  48. package/dist/src/ui/App.d.ts.map +1 -0
  49. package/dist/src/ui/App.js +164 -0
  50. package/dist/src/ui/App.js.map +1 -0
  51. package/dist/src/ui/components/Composer.d.ts +10 -0
  52. package/dist/src/ui/components/Composer.d.ts.map +1 -0
  53. package/dist/src/ui/components/Composer.js +13 -0
  54. package/dist/src/ui/components/Composer.js.map +1 -0
  55. package/dist/src/ui/components/Header.d.ts +7 -0
  56. package/dist/src/ui/components/Header.d.ts.map +1 -0
  57. package/dist/src/ui/components/Header.js +7 -0
  58. package/dist/src/ui/components/Header.js.map +1 -0
  59. package/dist/src/ui/components/Message.d.ts +12 -0
  60. package/dist/src/ui/components/Message.d.ts.map +1 -0
  61. package/dist/src/ui/components/Message.js +21 -0
  62. package/dist/src/ui/components/Message.js.map +1 -0
  63. package/dist/src/ui/components/MessageList.d.ts +9 -0
  64. package/dist/src/ui/components/MessageList.d.ts.map +1 -0
  65. package/dist/src/ui/components/MessageList.js +18 -0
  66. package/dist/src/ui/components/MessageList.js.map +1 -0
  67. package/dist/src/ui/components/Spinner.d.ts +6 -0
  68. package/dist/src/ui/components/Spinner.d.ts.map +1 -0
  69. package/dist/src/ui/components/Spinner.js +7 -0
  70. package/dist/src/ui/components/Spinner.js.map +1 -0
  71. package/dist/src/ui/components/StatusBar.d.ts +11 -0
  72. package/dist/src/ui/components/StatusBar.d.ts.map +1 -0
  73. package/dist/src/ui/components/StatusBar.js +7 -0
  74. package/dist/src/ui/components/StatusBar.js.map +1 -0
  75. package/dist/src/ui/components/index.d.ts +7 -0
  76. package/dist/src/ui/components/index.d.ts.map +1 -0
  77. package/dist/src/ui/components/index.js +7 -0
  78. package/dist/src/ui/components/index.js.map +1 -0
  79. package/dist/src/ui/headless.d.ts.map +1 -1
  80. package/dist/src/ui/headless.js +4 -9
  81. package/dist/src/ui/headless.js.map +1 -1
  82. package/dist/src/validation/error-formatter.d.ts +21 -0
  83. package/dist/src/validation/error-formatter.d.ts.map +1 -0
  84. package/dist/src/validation/error-formatter.js +98 -0
  85. package/dist/src/validation/error-formatter.js.map +1 -0
  86. package/dist/src/validation/index.d.ts +10 -0
  87. package/dist/src/validation/index.d.ts.map +1 -0
  88. package/dist/src/validation/index.js +10 -0
  89. package/dist/src/validation/index.js.map +1 -0
  90. package/dist/src/validation/json-validator.d.ts +25 -0
  91. package/dist/src/validation/json-validator.d.ts.map +1 -0
  92. package/dist/src/validation/json-validator.js +173 -0
  93. package/dist/src/validation/json-validator.js.map +1 -0
  94. package/dist/src/validation/schema.d.ts +353 -0
  95. package/dist/src/validation/schema.d.ts.map +1 -0
  96. package/dist/src/validation/schema.js +57 -0
  97. package/dist/src/validation/schema.js.map +1 -0
  98. package/dist/src/validation/suggestions.d.ts +25 -0
  99. package/dist/src/validation/suggestions.d.ts.map +1 -0
  100. package/dist/src/validation/suggestions.js +144 -0
  101. package/dist/src/validation/suggestions.js.map +1 -0
  102. package/dist/src/validation/types.d.ts +40 -0
  103. package/dist/src/validation/types.d.ts.map +1 -0
  104. package/dist/src/validation/types.js +5 -0
  105. package/dist/src/validation/types.js.map +1 -0
  106. package/dist/src/validation/yaml-validator.d.ts +25 -0
  107. package/dist/src/validation/yaml-validator.d.ts.map +1 -0
  108. package/dist/src/validation/yaml-validator.js +177 -0
  109. package/dist/src/validation/yaml-validator.js.map +1 -0
  110. package/package.json +12 -13
@@ -5,7 +5,7 @@
5
5
 
6
6
  ## 何时进入此阶段
7
7
  - 开发 Gate 通过后进入
8
- - RESEARCH.md 当前阶段 = 验证
8
+ - wiki/entities/projects/{slug}.md 当前阶段 = 验证
9
9
 
10
10
  ## Scout 在此阶段的角色
11
11
 
@@ -21,39 +21,39 @@
21
21
  - AQL 抽检(Level II, AQL 2.5)
22
22
  - 功能测试、外观检查、包装完整性
23
23
  - 合格标准:合格率 ≥ 95%
24
- - **落盘位置**:记录在 RESEARCH.md 关键发现中
24
+ - **更新页面**:记录在 wiki/entities/projects/{slug}.md 关键发现中
25
25
 
26
26
  ### 2. 小批量测试
27
27
  - 发 50-100 件到 FBA
28
28
  - 监控 2-4 周:转化率、退货率、客户反馈
29
29
  - 确认实际 FBA 费用
30
- - **落盘位置**:更新 RESEARCH.md FAN 模型(用实际数据替换假设)
30
+ - **更新页面**:更新 wiki/entities/projects/{slug}.md FAN 模型(用实际数据替换假设)
31
31
 
32
32
  ### 3. Listing A/B 测试
33
33
  - 主图变体、标题关键词、价格点
34
- - **落盘位置**:记录在 RESEARCH.md 关键发现中
34
+ - **更新页面**:记录在 wiki/entities/projects/{slug}.md 关键发现中
35
35
 
36
36
  ### 4. PPC 测试
37
37
  - 自动+手动精准广告
38
38
  - 2 周后分析实际 ACoS vs 预估
39
39
  - 调整出价和关键词
40
- - **落盘位置**:更新 RESEARCH.md FAN 模型中的 PPC 实际值
40
+ - **更新页面**:更新 wiki/entities/projects/{slug}.md FAN 模型中的 PPC 实际值
41
41
 
42
42
  ### 5. 首批评论分析
43
43
  - 前 10-20 条评论(`scout reviews MY_ASIN --pages 2`)
44
44
  - 正面是否验证差异化?负面有无预期外问题?
45
45
  - 参考 requirements.md 的"验证"步骤做需求满足度确认
46
- - **落盘位置**:`data/reviews/{ASIN}-post-launch.json` → 更新 `INDEX.md` + `reviews/PAIN-POINTS.md`
46
+ - **更新页面**:CLI 自动缓存评论数据 → 更新 `wiki/overview/pain-points-{slug}.md`
47
47
 
48
48
  ## ADCP Gate 评审
49
49
 
50
50
  5个问题:质量达标?转化≥品类平均且退货<5%?Listing就绪?ACoS在FAN假设±20%内?库存和资金就位?
51
51
 
52
52
  **Go(全 Yes):**
53
- 1. **生成上线验证报告**,保存到 `reports/YYYY-MM-DD-上线验证报告.md`。必含:质检结果、转化率/退货率实测数据、ACoS 实际 vs FAN 预估对比、首批评论分析、上线就绪度判断
54
- 2. 更新 RESEARCH.md 当前阶段 → 发布
55
- 3. 更新 RESEARCH.md 决策记录
56
- 4. 更新 OVERVIEW.md 阶段列
57
- 5. 更新 ROADMAP.md(状态 → 已通过 ADCP)
53
+ 1. **生成上线验证报告**,保存到 `wiki/analyses/YYYY-MM-DD-上线验证报告.md`。必含:质检结果、转化率/退货率实测数据、ACoS 实际 vs FAN 预估对比、首批评论分析、上线就绪度判断
54
+ 2. 更新 wiki/entities/projects/{slug}.md 当前阶段 → 发布
55
+ 3. 更新 wiki/entities/projects/{slug}.md 决策记录
56
+ 4. 更新 index.md 阶段列
57
+ 5. 更新 wiki/overview/roadmap.md(状态 → 已通过 ADCP)
58
58
 
59
59
  **不达标:** 标注具体问题,回开发阶段修正后重新评审
@@ -26,7 +26,7 @@
26
26
  - `scout product` 竞品 Feature Bullets(竞品已满足的需求)
27
27
  - Web Search 行业报告、论坛帖子
28
28
 
29
- **收集产出:** reviews/PAIN-POINTS.md 中的痛点聚类表和好评亮点表
29
+ **收集产出:** wiki/overview/pain-points-{slug}.md 中的痛点聚类表和好评亮点表
30
30
 
31
31
  ---
32
32
 
@@ -37,7 +37,7 @@
37
37
  - 差评聚类 → 痛点频率统计
38
38
  - 好评高频词 → 用户最在乎什么
39
39
 
40
- **分析产出:** competitors/COMPETITORS.md 中的差异化机会总结
40
+ **分析产出:** wiki/overview/competition-{slug}.md 中的差异化机会总结
41
41
 
42
42
  ---
43
43
 
@@ -58,11 +58,11 @@
58
58
  - 竞品在该维度的得分(竞品普遍弱 = 差异化机会大)
59
59
 
60
60
  **可行性评估依据:**
61
- - 供应商是否能实现?(已在 suppliers/SUPPLIERS.md 中确认)
61
+ - 供应商是否能实现?(已在 wiki/overview/suppliers-{slug}.md 中确认)
62
62
  - 成本增加多少?(对 FAN 模型的影响)
63
63
  - 是否需要新模具/认证?(时间和资金成本)
64
64
 
65
- **产出:** 更新 RESEARCH.md 关键发现,标注每个需求的优先级(P1/P2/P3/放弃)
65
+ **产出:** 更新 wiki/entities/projects/{slug}.md 关键发现,标注每个需求的优先级(P1/P2/P3/放弃)
66
66
 
67
67
  ---
68
68
 
@@ -70,7 +70,7 @@
70
70
 
71
71
  **目的:** 确保 P1 需求全部落实到产品规格中,不遗漏。
72
72
 
73
- **需求跟踪表(记录在 RESEARCH.md 关键发现中):**
73
+ **需求跟踪表(记录在 wiki/entities/projects/{slug}.md 关键发现中):**
74
74
 
75
75
  | 需求(痛点) | 优先级 | 对应产品规格 | 实现方式 | 状态 |
76
76
  |-------------|--------|------------|---------|------|
@@ -116,11 +116,11 @@
116
116
  - **验证阶段** 执行闭环确认(步骤 5)
117
117
  - **生命周期阶段** 持续跟踪需求满足度
118
118
 
119
- ## 落盘位置
119
+ ## 更新页面
120
120
 
121
121
  | 产出 | 存储位置 |
122
122
  |------|---------|
123
- | 痛点聚类和好评亮点 | reviews/PAIN-POINTS.md |
124
- | 需求优先级排序 | RESEARCH.md 关键发现 |
125
- | 需求跟踪表 | RESEARCH.md 关键发现 |
126
- | 验证结果 | RESEARCH.md 关键发现 |
123
+ | 痛点聚类和好评亮点 | wiki/overview/pain-points-{slug}.md |
124
+ | 需求优先级排序 | wiki/entities/projects/{slug}.md 关键发现 |
125
+ | 需求跟踪表 | wiki/entities/projects/{slug}.md 关键发现 |
126
+ | 验证结果 | wiki/entities/projects/{slug}.md 关键发现 |
@@ -0,0 +1,151 @@
1
+ # 产品研究知识库规则
2
+
3
+ ## 目标
4
+
5
+ 这个知识库积累 Amazon 产品研究的所有数据和分析,
6
+ 支持跨项目、跨品类的知识复用。
7
+
8
+ ## 素材规则
9
+
10
+ - `raw/` 是原始素材的存放目录,只增不改
11
+ - 原始素材来自 scout CLI 命令缓存(`~/.scout/cache/` 中的 JSON 文件)
12
+ - 文件名格式:`YYYY-MM-DD-<命令>-<参数摘要>.json`
13
+ - 收录时保留完整 meta 头(command、args、timestamp、source)
14
+ - `wiki/` 保存从原始数据中提炼的结构化知识
15
+ - 重要结论必须能追溯到 source 页
16
+
17
+ ## 数据来源类型
18
+
19
+ 本 KB 的 raw source 主要来自 scout CLI 命令缓存:
20
+
21
+ | 来源命令 | 数据类型 | 应创建/更新的页面 |
22
+ |---------|---------|----------------|
23
+ | scout search | Amazon 搜索结果 | sources/ + overview/market-{project} |
24
+ | scout product | 产品详情 | sources/ + entities/products/{ASIN} |
25
+ | scout reviews | 产品评论 | sources/ + overview/pain-points-{project} |
26
+ | scout keepa product | 历史趋势 | sources/ + entities/products/{ASIN} + overview/trends-{project} |
27
+ | scout keepa search/bestsellers/deals | Keepa 筛选/榜单 | sources/ + overview/market-{project} |
28
+ | scout keepa seller | 卖家信息 | sources/ + entities/brands/{name} |
29
+ | scout sp keywords | ASIN 流量关键词 | sources/ + entities/products/{ASIN} |
30
+ | scout sp keywords-mine | 关键词搜索量 | sources/ + overview/market-{project} |
31
+ | scout sp keywords-order | ASIN 出单关键词 | sources/ + entities/products/{ASIN} |
32
+ | scout sp keywords-research/trends | 关键词市场分析 | sources/ + overview/market-{project} |
33
+ | scout sp predict | ASIN 销量预测 | sources/ + entities/products/{ASIN} |
34
+ | scout sp competitors | 竞品列表 | sources/ + overview/competition-{project} |
35
+ | scout sp coupon | 优惠趋势 | sources/ + entities/products/{ASIN} |
36
+ | scout sp brands | 品牌集中度 | sources/ + entities/brands/* + overview/competition-{project} |
37
+ | scout sp sellers/seller-countries/seller-types | 卖家分布 | sources/ + overview/competition-{project} |
38
+ | scout sp market/market-stats/demand/prices/ratings/listing-* | 类目市场数据 | sources/ + entities/categories/{name} + overview/market-{project} |
39
+ | scout sp ebc/products | 类目 Listing 分布 | sources/ + overview/competition-{project} |
40
+ | scout sp google-trend | 谷歌趋势 | sources/ + overview/market-{project} |
41
+ | scout sp aba-weekly/monthly/trend | ABA 数据 | sources/ + overview/market-{project} |
42
+ | scout sp category | 类目树 | sources/ + entities/categories/{name} |
43
+ | scout supplier-search/supplier-search-image | 1688 供应商 | sources/ + entities/suppliers/* + overview/suppliers-{project} |
44
+ | scout tiktok/reddit/twitter/instagram | 社交趋势 | sources/ + overview/market-{project} |
45
+ | scout douyin/xhs/taobao | 中国平台 | sources/ + overview/market-{project} |
46
+ | scout shein-search/temu-search | 竞品平台 | sources/ + overview/market-{project} |
47
+
48
+ **兜底规则**:未在上表列出的 scout 命令,默认只创建 sources/ 页,不自动创建 entity。
49
+
50
+ ## Entity 类型
51
+
52
+ | 类型 | 路径 | 创建方式 | 包含什么 |
53
+ |------|------|---------|---------|
54
+ | 卖家画像 | entities/seller-profile.md | 手动(首次初始化时创建) | 目标市场、价位、预算、决策标准 |
55
+ | 研究项目 | entities/projects/{slug}.md | 手动(立项时创建) | IPD 阶段、checklist、SPAN、FAN、决策记录 |
56
+ | 品牌 | entities/brands/{name}.md | ingest 自动创建 | 品牌信息、ASIN 列表、市场份额、跨项目出现 |
57
+ | 竞品 | entities/products/{ASIN}.md | ingest 自动创建 | 产品详情、评论摘要、关键词、历史趋势 |
58
+ | 供应商 | entities/suppliers/{name}.md | ingest 自动创建 | 价格、MOQ、能力、合作记录 |
59
+ | 品类 | entities/categories/{name}.md | ingest 自动创建 | 品类概况、子品类、市场规模 |
60
+
61
+ ## Overview 类型
62
+
63
+ | 类型 | 路径 | 包含什么 |
64
+ |------|------|---------|
65
+ | 产品路标 | overview/roadmap.md | 品类机会池、优先级排序、时间线 |
66
+ | 能力货架 | overview/cbb.md | 跨项目可复用的供应商/物流/知识 |
67
+ | 市场分析 | overview/market-{project}.md | 市场概况、子品类分布、需求验证 |
68
+ | 竞争格局 | overview/competition-{project}.md | 品牌集中度、卖家构成、Listing 能力 |
69
+ | 痛点分析 | overview/pain-points-{project}.md | 差评聚类、好评亮点、差异化方向 |
70
+ | 趋势分析 | overview/trends-{project}.md | Keepa BSR、季节性、生命周期 |
71
+ | 供应商分析 | overview/suppliers-{project}.md | 供应商对比、成本测算 |
72
+
73
+ ## Analysis 类型
74
+
75
+ | 类型 | 路径 | 包含什么 |
76
+ |------|------|---------|
77
+ | 产品立项书 | analyses/{project}-charter.md | CDCP Gate 产出 |
78
+ | 商业计划书 | analyses/{project}-business-case.md | PDCP Gate 产出 |
79
+ | SPAN 定位 | analyses/{project}-span.md | 战略定位分析 |
80
+ | FAN 财务模型 | analyses/{project}-fan.md | 单元经济 + 场景分析 |
81
+ | 品类分析报告 | analyses/mm-{topic}.md | MM 阶段产出 |
82
+ | Portfolio 分析 | analyses/portfolio-{date}.md | 跨项目对比 |
83
+
84
+ ## 工作流
85
+
86
+ ### Ingest(收录)
87
+
88
+ 1. 将 `~/.scout/cache/{project}/` 中的缓存文件复制到 `raw/`
89
+ 2. 在 `wiki/sources/` 创建来源页(结构化摘要,不是原始 JSON 复制)
90
+ 3. 根据"数据来源类型"表,创建/更新相关 entity 和 overview 页面:
91
+ - scout search 数据 → 提取每个 ASIN 的基础信息,已有 entity 页则更新,否则仅记录在 source 页
92
+ - scout product 数据 → 必须创建/更新 entities/products/{ASIN}.md
93
+ - scout sp brands 数据 → 为每个头部品牌创建/更新 entities/brands/{name}.md
94
+ - scout supplier-search 数据 → 为报价合理的供应商创建 entities/suppliers/{name}.md
95
+ - 社交趋势数据 → 不创建 entity,仅 source + overview
96
+ 4. 更新 `index.md` 索引
97
+ 5. 在 `log.md` 追加记录(日期 + 收录了什么 + 更新了哪些页面)
98
+ 6. git commit
99
+
100
+ ### Query(查询)
101
+
102
+ 1. 先查 `index.md` 定位相关页面
103
+ 2. 读取相关 wiki 页面回答问题
104
+ 3. 如果 wiki 页面信息不足,查 `raw/` 原始 JSON 补充
105
+ 4. 如果知识库内无答案,建议执行 scout 命令获取新数据
106
+
107
+ ### Lint(检查)
108
+
109
+ 1. 检查页面是否符合命名约定
110
+ 2. 检查 entity 页面是否聚焦(一个 ASIN 一页,一个品牌一页)
111
+ 3. 检查 `index.md` 是否与实际文件一致
112
+ 4. 检查 overview 页面是否有过时数据(对比 raw/ 中最新来源日期)
113
+ 5. 检查是否有孤立页面(无 source 引用的 entity)
114
+
115
+ ## 编辑规则
116
+
117
+ - 事实性内容必须标注来源(source 页文件名或 raw/ 文件路径)
118
+ - 冲突数据并列呈现,标注各自来源和日期
119
+ - entity 页面保持聚焦:一个 ASIN 一个页面,一个品牌一个页面
120
+ - overview 页面按项目分:market-{project}.md 只包含该项目的市场分析
121
+ - 品牌和供应商的 entity 页面可以被多个项目引用(跨项目复用)
122
+ - 页面开头用一句话概括本页内容
123
+
124
+ ## 命名约定
125
+
126
+ | 目录 | 格式 | 示例 |
127
+ |------|------|------|
128
+ | sources/ | `YYYY-MM-DD-<命令>-<参数>.md` | `2026-05-08-search-3d-printed-toys.md` |
129
+ | entities/products/ | `<ASIN>.md` | `B0DTJD9939.md` |
130
+ | entities/brands/ | `<kebab-case-品牌名>.md` | `rapean.md` |
131
+ | entities/suppliers/ | `<kebab-case-供应商名>.md` | `shenzhen-aori.md` |
132
+ | entities/categories/ | `<kebab-case-品类名>.md` | `3d-printed-toys.md` |
133
+ | entities/projects/ | `<kebab-case-项目名>.md` | `3d-printed-toys.md` |
134
+ | overview/ | `<类型>-<项目名>.md` | `market-3d-printed-toys.md` |
135
+ | analyses/ | `<项目名>-<类型>.md` | `3d-printed-toys-charter.md` |
136
+
137
+ ## 何时新建页面
138
+
139
+ - 一个 ASIN 在 2 个以上 source 中出现 → 建 entities/products/ 页
140
+ - 一个品牌在品牌集中度数据中占份额 ≥ 5% → 建 entities/brands/ 页
141
+ - 一个供应商报价合理且有差异化能力 → 建 entities/suppliers/ 页
142
+ - 一个页面超过 300 行 → 拆分
143
+ - 新的 scout 命令缓存文件 → 建 sources/ 页
144
+
145
+ ## 输出要求
146
+
147
+ Agent 修改知识库后须:
148
+ 1. 更新 `index.md`(如有新增/删除/重命名页面)
149
+ 2. 在 `log.md` 追加一行记录(日期 + 操作摘要)
150
+ 3. 确保新内容与已有页面不冲突或已标注冲突
151
+ 4. git commit
@@ -0,0 +1,113 @@
1
+ # {产品名称}
2
+
3
+ ## 基本信息
4
+ - 创建时间: {date}
5
+ - 当前阶段: 概念 | 计划 | 开发 | 验证 | 发布 | 生命周期
6
+ - 状态: 进行中 | 暂停 | 已决策(Go) | 已决策(No-Go)
7
+
8
+ ## 研究目标
9
+ {为什么研究这个产品?初始假设是什么?}
10
+
11
+ ## SPAN 定位
12
+ - 市场吸引力: {高/中/低}(规模、增长率、利润潜力)
13
+ - 竞争地位: {强/中/弱}(差异化能力、资金、供应链)
14
+ - 战略象限: 投资 | 选择性投入 | 收割 | 退出
15
+
16
+ ## 阶段进度
17
+
18
+ ### 概念阶段(产品立项书)
19
+ - [ ] 趋势扫描(TikTok/Reddit/Twitter/Web Search 发现热度信号)
20
+ - [ ] Amazon 市场全景扫描(多关键词 ×50 条 + 竞品补充,覆盖 30+ 竞品)
21
+ - [ ] 子品类聚类(识别 5+ 子品类,标注各自规模和竞争度)
22
+ - [ ] 需求验证(精确月搜索量、购买量、转化率)
23
+ - [ ] 竞争格局(品牌集中度、卖家国籍分布、各子品类竞争强度)
24
+ - [ ] SPAN 初步定位(市场吸引力 + 竞争地位)
25
+ - [ ] 初步利润估算(毛利率 > PROFILE 最低毛利率?)
26
+ - [ ] 供应端初探(1688 参考价,≥3 家供应商报价)
27
+ - [ ] IP/合规初筛(商标、专利、认证要求)
28
+ - [ ] **数据完整性检查通过**(10 项全部通过)
29
+ - **CDCP Gate**: 市场够大?利润够高?竞争可打?无 IP 风险?
30
+
31
+ ### 计划阶段(商业计划书)
32
+ - [ ] 头部竞品深挖(5-8 个,含产品详情 + 流量关键词 + Listing 能力矩阵)
33
+ - [ ] 历史销量与季节性分析(14 个月销量数据,识别波峰波谷)
34
+ - [ ] $APPEALS 竞品评分(TOP 5 竞品 8 维度打分)
35
+ - [ ] 用户痛点挖掘(差评聚类 → 差异化方向)
36
+ - [ ] 历史趋势分析(Keepa BSR/价格/卖家数 → 生命周期判断)
37
+ - [ ] 差异化策略(基于 $APPEALS 缺口确定产品定位)
38
+ - [ ] FAN 财务分析(单元经济、盈亏平衡、场景分析、回本周期)
39
+ - [ ] 供应商初步接触(3-5 家询价、MOQ、交期)
40
+ - [ ] 风险评估(竞争加剧、价格战、季节性、合规变化)
41
+ - [ ] **数据完整性检查通过**(13 项全部通过)
42
+ - **PDCP Gate**: 有明确差异化?供应商可行?商业计划书成立?
43
+
44
+ ### 开发阶段(产品实现)
45
+ - [ ] 供应商评估与选定(质量/交期/配合度/定制能力)
46
+ - [ ] 成本模型定稿(原材料+制造+包装+运费+关税+FBA prep)
47
+ - [ ] 产品规格确认(材料、尺寸、包装、认证)
48
+ - [ ] 样品迭代(至少 2 轮打样确认)
49
+ - [ ] 包装设计(品牌包装、FBA 尺寸优化)
50
+ - [ ] Listing 素材准备(图片、A+、视频)
51
+ - **开发 Gate**: 样品达标?成本在预算内?Listing 就绪?
52
+
53
+ ### 验证阶段(上线验证)
54
+ - [ ] 第三方质检(AQL 抽检)
55
+ - [ ] 小批量测试(50-100 件,验证转化率和退货率)
56
+ - [ ] Listing A/B 测试(主图、标题变体)
57
+ - [ ] PPC 测试(验证 ACoS 假设)
58
+ - [ ] 首批评论分析(前 10-20 条反馈)
59
+ - **ADCP Gate**: 质量过关?转化达预期?ACoS 可控?
60
+
61
+ ### 发布阶段
62
+ - [ ] 正式库存到仓
63
+ - [ ] Launch 推广策略执行
64
+ - [ ] 评论加速计划
65
+ - [ ] 竞品动态监控
66
+
67
+ ### 生命周期
68
+ - [ ] 月度复盘(BSR/评论/竞品/利润 vs 商业计划书)
69
+ - [ ] 变体扩展评估
70
+ - [ ] EOL 决策(何时退出)
71
+
72
+ ## $APPEALS 评分卡
73
+
74
+ | 维度 | 本品(目标)| 竞品A | 竞品B | 竞品C | 差距/机会 |
75
+ |------|-----------|-------|-------|-------|----------|
76
+ | $ 价格 | | | | | |
77
+ | A 可获得性 | | | | | |
78
+ | P 包装 | | | | | |
79
+ | P 性能 | | | | | |
80
+ | E 易用性 | | | | | |
81
+ | A 保证 | | | | | |
82
+ | L 生命周期成本 | | | | | |
83
+ | S 社会接受度 | | | | | |
84
+
85
+ ## FAN 财务模型
86
+
87
+ | 项目 | 数值 | 备注 |
88
+ |------|------|------|
89
+ | 售价 | | |
90
+ | COGS(1688 采购) | | |
91
+ | 头程运费 + 关税 | | |
92
+ | FBA 费用 | | |
93
+ | **毛利** | | 售价 - COGS - 运费关税 - FBA |
94
+ | **毛利率** | | 概念阶段判断用 |
95
+ | PPC 分摊/单位 | | |
96
+ | 退货损耗 | | |
97
+ | 其他费用 | | |
98
+ | **单位净利润** | | 毛利 - PPC - 退货 - 其他 |
99
+ | **净利率** | | 计划阶段判断用 |
100
+ | 盈亏平衡(月销量) | | |
101
+ | 首批投入 | | |
102
+ | 回本周期 | | |
103
+
104
+ ## 关键发现
105
+ {研究过程中的重要发现,随时更新}
106
+
107
+ ## 风险清单
108
+ | 风险 | 影响 | 概率 | 应对 |
109
+ |------|------|------|------|
110
+
111
+ ## 决策记录
112
+ | 日期 | Gate | 决策 | 依据 |
113
+ |------|------|------|------|
@@ -0,0 +1,23 @@
1
+ # 卖家画像
2
+
3
+ ## 基本信息
4
+ - 店铺:
5
+ - 主营市场:
6
+ - 经营阶段: 初创 | 成长 | 成熟
7
+
8
+ ## 选品偏好
9
+ - 目标价位:
10
+ - 偏好品类:
11
+ - 回避品类:
12
+ - 风险偏好: 保守 | 中等 | 激进
13
+
14
+ ## 供应链能力
15
+ - 单品启动预算:
16
+ - 已有供应商资源:
17
+ - 物流方式偏好: FBA | 海外仓 | 自发货
18
+
19
+ ## 决策标准
20
+ - 最低毛利率: 50%
21
+ - 最低净利率: 30%
22
+ - 最大可接受 MOQ:
23
+ - 其他红线:
@@ -0,0 +1,33 @@
1
+ # 能力货架(CBB)
2
+
3
+ 跨产品可复用的能力模块。新建项目时优先从货架取用已有能力,缩短开发周期、降低风险。
4
+
5
+ ## 供应商能力
6
+
7
+ | 供应商 | 品类 | 能力 | 合作产品 | 评价 |
8
+ |--------|------|------|---------|------|
9
+
10
+ ## 物流能力
11
+
12
+ | 线路/货代 | 方式 | 覆盖区域 | 时效 | 评价 |
13
+ |-----------|------|---------|------|------|
14
+
15
+ ## 品类知识
16
+
17
+ | 品类 | 认证经验 | 合规方案 | 关键坑点 | 来源项目 |
18
+ |------|---------|---------|---------|---------|
19
+
20
+ ## 运营能力
21
+
22
+ | 能力 | 说明 | 适用品类 | 来源项目 |
23
+ |------|------|---------|---------|
24
+
25
+ ## 品牌资产
26
+
27
+ | 资产 | 状态 | 覆盖市场 | 说明 |
28
+ |------|------|---------|------|
29
+
30
+ ## 技术/设计
31
+
32
+ | 模块 | 说明 | 可复用场景 | 来源项目 |
33
+ |------|------|-----------|---------|
@@ -0,0 +1,33 @@
1
+ # 竞品分析
2
+
3
+ ## TOP 竞品概览
4
+
5
+ | ASIN | 产品名 | 价格 | 评分 | 评论数 | BSR | 月销估算 | 卖家类型 |
6
+ |------|--------|------|------|--------|-----|---------|---------|
7
+
8
+ ## $APPEALS 对比
9
+
10
+ | 维度 | 行业均值 | 竞品A | 竞品B | 竞品C | 缺口机会 |
11
+ |------|---------|-------|-------|-------|---------|
12
+ | $ 价格 | | | | | |
13
+ | A 可获得性 | | | | | |
14
+ | P 包装 | | | | | |
15
+ | P 性能 | | | | | |
16
+ | E 易用性 | | | | | |
17
+ | A 保证 | | | | | |
18
+ | L 生命周期成本 | | | | | |
19
+ | S 社会接受度 | | | | | |
20
+
21
+ ## Listing 能力矩阵
22
+ | ASIN | 图片数 | A+ | 视频 | Bullets 质量 | 品牌注册 | Coupon/促销 | 优化空间 |
23
+ |------|--------|----|----- |------------|---------|-----------|---------|
24
+
25
+ ## 季节性分析(14 个月历史销量)
26
+
27
+ | ASIN | 产品名 | 波峰月份 | 波谷月份 | 旺季/淡季倍数 | 趋势方向 |
28
+ |------|--------|---------|---------|-------------|---------|
29
+
30
+ {基于 scout sp predict 数据,分析季节规律和最佳上架时间}
31
+
32
+ ## 差异化机会总结
33
+ {基于 $APPEALS 缺口 + 差评痛点 + 子品类空白,用户最在乎但竞品最弱的交叉维度}
@@ -0,0 +1,32 @@
1
+ # 市场分析
2
+
3
+ ## 市场概况
4
+ - 估算月总销量:
5
+ - 月搜索量:
6
+ - 价格区间:
7
+ - 主要关键词:
8
+
9
+ ## 趋势信号
10
+ | 来源 | 信号 | 日期 | 强度 |
11
+ |------|------|------|------|
12
+
13
+ ## 需求验证
14
+ - 搜索量趋势:
15
+ - BSR 分布:
16
+ - 季节性:
17
+
18
+ ## 子品类分布
19
+
20
+ | 子品类 | 产品数 | 价格区间 | 头部评论数 | 增长信号 | 竞争度 |
21
+ |--------|--------|---------|-----------|---------|--------|
22
+
23
+ ## 竞争格局
24
+ - 竞品总数:
25
+ - 头部品牌:
26
+ - 品牌集中度 (CR3/CR5):
27
+ - 卖家国籍分布:
28
+ - FBA/FBM 占比:
29
+
30
+ ## SPAN 初步评分
31
+ - 市场吸引力: /5
32
+ - 竞争地位: /5
@@ -0,0 +1,19 @@
1
+ # 用户痛点分析
2
+
3
+ ## 数据来源
4
+ - 分析评论数:
5
+ - 覆盖产品:
6
+ - 筛选条件:
7
+
8
+ ## 痛点聚类
9
+
10
+ | 痛点类别 | 提及频率 | 典型评论摘要 | 影响的 $APPEALS 维度 | 改进可行性 |
11
+ |---------|---------|------------|-------------------|-----------|
12
+
13
+ ## 好评亮点
14
+
15
+ | 卖点类别 | 提及频率 | 典型评论摘要 | 对应 $APPEALS 维度 |
16
+ |---------|---------|------------|-------------------|
17
+
18
+ ## 差异化方向
19
+ {综合痛点 + 亮点,确定产品应该在哪些维度做到极致}
@@ -0,0 +1,41 @@
1
+ # 产品路标规划
2
+
3
+ 基于市场管理(MM)输出的产品线规划,指导未来 12-24 个月的选品方向和资源配比。
4
+
5
+ ## 战略方向
6
+
7
+ - 目标市场:
8
+ - 核心品类:
9
+ - 扩展品类:
10
+ - 回避领域:
11
+
12
+ ## 品类机会池
13
+
14
+ 通过 MM(市场管理)流程识别的机会清单,按优先级排列。每个机会经过概念阶段验证后进入正式研究。
15
+
16
+ | 优先级 | 品类/产品方向 | 市场吸引力 | 竞争地位 | SPAN 象限 | 状态 | 备注 |
17
+ |--------|-------------|-----------|---------|----------|------|------|
18
+
19
+ ## 产品线规划
20
+
21
+ 按时间线排列的产品开发计划。
22
+
23
+ | 季度 | 产品 | 当前阶段 | 目标阶段 | 关键里程碑 | 资源投入 |
24
+ |------|------|---------|---------|-----------|---------|
25
+
26
+ ## 资源预算分配
27
+
28
+ | 品类/产品 | 研发预算 | 首批库存 | 推广预算 | 合计 | 预期回报 |
29
+ |-----------|---------|---------|---------|------|---------|
30
+
31
+ ## MM(市场管理)复盘记录
32
+
33
+ | 日期 | 动作 | 说明 |
34
+ |------|------|------|
35
+ | | 新增机会 / 调整优先级 / 移除机会 | |
36
+
37
+ ## 更新节奏
38
+
39
+ - **季度**:全面复盘产品路标,调整优先级和资源分配
40
+ - **月度**:更新各产品阶段进展,识别新机会
41
+ - **随时**:发现新市场信号时添加到品类机会池
@@ -0,0 +1,34 @@
1
+ # 供应商分析
2
+
3
+ ## 搜索结果概览
4
+ - 搜索方式: 关键词 / 图片 / 两者
5
+ - 供应商数量:
6
+ - 价格区间:
7
+
8
+ ## TOP 供应商对比
9
+
10
+ | 供应商 | 价格 | MOQ | 交期 | 年限 | 类型 | 定制能力 | 综合评分 |
11
+ |--------|------|-----|------|------|------|---------|---------|
12
+
13
+ ## 成本测算
14
+
15
+ | 项目 | 金额 | 说明 |
16
+ |------|------|------|
17
+ | 采购单价 | ¥ | |
18
+ | 包装 | ¥ | |
19
+ | 头程运费 | ¥/件 | |
20
+ | 关税 | ¥/件 | |
21
+ | FBA prep | ¥/件 | |
22
+ | **落地成本** | ¥/件 | |
23
+ | **落地成本(美元)** | $ | |
24
+
25
+ ## 供应商评估矩阵
26
+ | 维度 | 供应商A | 供应商B | 供应商C |
27
+ |------|--------|--------|--------|
28
+ | 产品质量 | | | |
29
+ | MOQ 灵活性 | | | |
30
+ | 交期可靠性 | | | |
31
+ | 沟通配合度 | | | |
32
+ | 定制能力 | | | |
33
+ | 价格竞争力 | | | |
34
+ | 认证资质 | | | |
@@ -0,0 +1,23 @@
1
+ # 历史趋势分析
2
+
3
+ ## 数据来源
4
+ - 分析产品:
5
+ - 时间跨度:
6
+ - 数据来源: Keepa API
7
+
8
+ ## BSR 趋势
9
+ | ASIN | 当前 BSR | 90天前 BSR | 趋势方向 | salesRankDrops30 | salesRankDrops90 |
10
+ |------|---------|-----------|---------|-----------------|-----------------|
11
+
12
+ ## 生命周期判断
13
+ - 当前阶段: 增长期 | 成熟期 | 衰退期
14
+ - 判断依据:
15
+
16
+ ## 价格稳定性
17
+ | ASIN | 当前价 | 90天最低 | 90天最高 | 价格战风险 |
18
+ |------|--------|---------|---------|-----------|
19
+
20
+ ## 竞争趋势
21
+ - 卖家数量变化:
22
+ - 新进入者:
23
+ - 断货率:
File without changes
File without changes
File without changes
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import "@optima-chat/comfy-cli";
3
+ //# sourceMappingURL=comfy.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comfy.d.ts","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import "@optima-chat/comfy-cli";
3
+ //# sourceMappingURL=comfy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"comfy.js","sourceRoot":"","sources":["../../bin/comfy.ts"],"names":[],"mappings":";AACA,OAAO,wBAAwB,CAAC"}
File without changes
package/dist/bin/gen.js CHANGED
File without changes
File without changes
@@ -0,0 +1,3 @@
1
+ #!/usr/bin/env node
2
+ import "@optima-chat/growth-cli";
3
+ //# sourceMappingURL=growth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"growth.d.ts","sourceRoot":"","sources":["../../bin/growth.ts"],"names":[],"mappings":";AACA,OAAO,yBAAyB,CAAC"}