@optima-chat/optima-agent 0.9.33 → 0.9.35

package/.claude/skills/scout/SKILL.md

@@ -232,10 +232,10 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 用户可随时要求生成报告，保存到 `~/products/{slug}/reports/YYYY-MM-DD-{标题}.md`。
 
 报告类型对齐 IPD 交付物：
-- 概念阶段 → Charter（产品立项书）
-- 计划阶段 → Business Case（商业计划书）
+- 概念阶段 → 产品立项书
+- 计划阶段 → 商业计划书
 - 开发阶段 → 产品规格书 + 供应商评估报告
-- 验证阶段 → Pre-launch 验证报告
+- 验证阶段 → 上线验证报告
 - 跨项目 → Portfolio 分析报告
 
 **报告建议时机：**
@@ -244,11 +244,11 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 - 用户主动要求："总结一下"、"值得做吗？"、"所以你觉得呢？"
 
 **建议话术：**
-> "我已经分析了 X 组搜索和 Y 个竞品，有一些发现。要不要我整理成一份 {Charter/Business Case}？"
+> "我已经分析了 X 组搜索和 Y 个竞品，有一些发现。要不要我整理成一份 {产品立项书/商业计划书}？"
 
 如果用户拒绝，尊重决策："好的，有需要随时告诉我。"后续发现新数据后可再次建议。
 
-**Charter 报告必含章节：**
+**产品立项书必含章节：**
 - 市场概况（规模、增长、价格区间）
 - SPAN 定位（市场吸引力 + 竞争地位评分）
 - 竞争格局（头部竞品、品牌集中度）
@@ -256,7 +256,7 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 - 机会与风险
 - 建议（Go/Kill/Redirect）
 
-**Business Case 报告必含章节：**
+**商业计划书必含章节：**
 - $APPEALS 竞品对比分析
 - 用户痛点与差异化策略
 - 历史趋势分析（Keepa 数据）

package/.claude/skills/scout/references/commands.md

@@ -798,3 +798,57 @@ scout sp market "172282:24046923011:172541:12097478011"
 # 3. 用同一 nodeIdPath 查品牌集中度
 scout sp brands "172282:24046923011:172541:12097478011"
 ```
+
+---
+
+## 21-32. 其他 scout sp 命令
+
+以下命令参数模式与上述 #15-#20 一致，不再逐一展开。
+
+### 关键词/流量类
+
+| 命令 | 用途 | 关键返回字段 |
+|------|------|------------|
+| `scout sp keywords-research <keyword>` | 关键词市场分析 | searches, purchases, purchaseRate, growth, brands, categories, bid |
+| `scout sp keywords-trends <keyword>` | 关键词历史趋势（2017-至今） | 每月 search/purchases/purchaseRate/growth |
+| `scout sp traffic-stats <ASIN>` | 流量关键词概览统计 | keywords 总数, ranks, ads 数 |
+| `scout sp traffic-source <ASIN>` | 流量来源结构 | 各来源类型的关键词数和占比 |
+| `scout sp traffic-listing <ASIN>` | 免费/付费流量分布 | 各流量类型的数量 |
+| `scout sp traffic-related <ASIN>` | 关联商品列表 | 关联 ASIN、关联类型、关联强度 |
+| `scout sp traffic-extend <ASIN>` | 批量关键词拓展 | 扩展关键词列表（含搜索量、竞价） |
+
+### 产品类
+
+| 命令 | 用途 | 关键返回字段 |
+|------|------|------------|
+| `scout sp predict <ASIN>` | 销量预测（14 个月） | 日/月销量、销售额预测 |
+| `scout sp competitors <ASIN>` | 竞品查询 | 销量/销额/BSR/价格/利润/评分/FBA 类型 |
+| `scout sp coupon <ASIN>` | 优惠趋势 | 原价/优惠类型/优惠金额/最终成交价 |
+
+### 市场类（先通过 `scout sp category` 获取 nodeIdPath）
+
+| 命令 | 用途 | 关键返回字段 |
+|------|------|------------|
+| `scout sp market-stats <nodeIdPath>` | 类目统计 | 与 market 类似，更侧重统计指标 |
+| `scout sp sellers <nodeIdPath>` | 卖家集中度 | 头部卖家名称/销量份额/销额份额 |
+| `scout sp demand <nodeIdPath>` | 需求趋势 | 页面浏览量/商品数/退货率趋势 |
+| `scout sp prices <nodeIdPath>` | 价格分布 | 各价格区间的商品数/销量/销额 |
+| `scout sp ratings <nodeIdPath>` | 评分数分布 | 各评分数区间（进入难度） |
+| `scout sp rating-values <nodeIdPath>` | 评分值分布 | 各评分值区间（市场成熟度） |
+| `scout sp listing-dates <nodeIdPath>` | 上架时间分布 | 各时间区间商品数（新品接受度） |
+| `scout sp listing-trends <nodeIdPath>` | 上架趋势 | 按绝对上架时间统计 |
+| `scout sp seller-countries <nodeIdPath>` | 卖家所属地分布 | 各国家卖家数/销量占比 |
+| `scout sp seller-types <nodeIdPath>` | 发货类型分布 | FBA/FBM/Amazon 自营占比 |
+| `scout sp ebc <nodeIdPath>` | A+视频分布 | 有/无 A+和视频的商品占比 |
+| `scout sp products <nodeIdPath>` | 商品集中度 | 头部商品排名/销量/销额集中度 |
+
+### 其他
+
+| 命令 | 用途 | 关键返回字段 |
+|------|------|------------|
+| `scout sp google-trend <keyword>` | 谷歌搜索趋势 | 按月/周的搜索热度指数 |
+| `scout sp aba-weekly <keyword>` | ABA 周数据选品 | 热门/异动/增长/潜力关键词 |
+| `scout sp aba-monthly <keyword>` | ABA 月数据选品 | 同上（月维度） |
+| `scout sp aba-trend <keyword>` | ABA 关键词趋势 | ABA 排名和搜索量历史 |
+
+所有 `scout sp` 命令通用选项：`-m, --marketplace <code>`（默认 US）、`-f, --format <format>`（json/text）。

package/.claude/skills/scout/references/concept.md

@@ -2,7 +2,7 @@
 
 ## 目标
 
-验证产品机会是否值得投入更多资源研究。产出 Charter 初版（即完成 RESEARCH.md 概念阶段所有 checklist 项）。
+验证产品机会是否值得投入更多资源研究。产出产品立项书初版（即完成 RESEARCH.md 概念阶段所有 checklist 项）。
 
 ## 何时进入此阶段
 
@@ -211,7 +211,7 @@
 ### 各决策结果的具体操作
 
 **Go：**
-1. **生成 Charter（产品立项书）报告**，保存到 `reports/YYYY-MM-DD-Charter.md`。Charter 必含：市场概况、SPAN 定位、竞争格局、初步利润估算、机会与风险、Go 建议
+1. **生成产品立项书**，保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含：市场概况、SPAN 定位、竞争格局、初步利润估算、机会与风险、Go 建议
 2. 更新 RESEARCH.md 当前阶段 → 计划
 3. 更新 RESEARCH.md 决策记录
 4. 更新 OVERVIEW.md 阶段列

package/.claude/skills/scout/references/lifecycle.md

@@ -10,7 +10,7 @@
 ## 关键活动
 
 ### 月度复盘
-对比实际 vs Business Case：
+对比实际 vs 商业计划书：
 
 | 指标 | 预估 | 实际 | 偏差 |
 |------|------|------|------|

package/.claude/skills/scout/references/planning.md

@@ -2,7 +2,7 @@
 
 ## 目标
 
-深入验证产品可行性，产出完整 Business Case。通过 $APPEALS 找到差异化、通过 FAN 确认财务可行。
+深入验证产品可行性，产出完整商业计划书。通过 $APPEALS 找到差异化、通过 FAN 确认财务可行。
 
 ## 何时进入此阶段
 
@@ -129,7 +129,7 @@
 
 **目的**：验证产品财务可行性，确认利润空间
 
-**前置检查**：读取 `~/products/PROFILE.md` 的决策标准（最低毛利率、最低净利率）。如果 PROFILE 未填写这些阈值，**必须先让用户确认**："你的最低可接受净利率是��少？（默认 30%）"——否则 PDCP Gate 无法判断。
+**前置检查**：读取 `~/products/PROFILE.md` 的决策标准（最低毛利率、最低净利率）。如果 PROFILE 未填写这些阈值，**必须先让用户确认**："你的最低可接受净利率是多少？（默认 30%）"——否则 PDCP Gate 无法判断。
 
 **具体命令**：
 - `scout supplier-search "关键词" --limit 20`（文字搜索供应商）
@@ -239,7 +239,7 @@
 ### Go/Kill/Redirect 标准及操作
 
 **Go（5 项全部通过）：**
-1. **生成 Business Case（商业计划书）报告**，保存到 `reports/YYYY-MM-DD-BusinessCase.md`。必含：$APPEALS 对比、痛点与差异化策略、Keepa 趋势、FAN 财务模型（含场景分析）、供应商评估、风险清单、进入策略
+1. **生成商业计划书**，保存到 `reports/YYYY-MM-DD-商业计划书.md`。必含：$APPEALS 对比、痛点与差异化策略、Keepa 趋势、FAN 财务模型（含场景分析）、供应商评估、风险清单、进入策略
 2. 更新 RESEARCH.md 当前阶段 → 开发
 3. 更新 RESEARCH.md 决策记录
 4. 更新 OVERVIEW.md 阶段列

package/.claude/skills/scout/references/qualification.md

@@ -1,7 +1,7 @@
 # 验证阶段指引
 
 ## 目标
-通过小规模实测验证 Business Case 假设。确认产品/Listing/广告组合可行。
+通过小规模实测验证 商业计划书假设。确认产品/Listing/广告组合可行。
 
 ## 何时进入此阶段
 - 开发 Gate 通过后进入
@@ -50,7 +50,7 @@
 5个问题：质量达标？转化≥品类平均且退货<5%？Listing就绪？ACoS在FAN假设±20%内？库存和资金就位？
 
 **Go（全 Yes）：**
-1. **生成 Pre-launch 验证报告**，保存到 `reports/YYYY-MM-DD-验证报告.md`。必含：质检结果、转化率/退货率实测数据、ACoS 实际 vs FAN 预估对比、首批评论分析、上线就绪度判断
+1. **生成上线验证报告**，保存到 `reports/YYYY-MM-DD-上线验证报告.md`。必含：质检结果、转化率/退货率实测数据、ACoS 实际 vs FAN 预估对比、首批评论分析、上线就绪度判断
 2. 更新 RESEARCH.md 当前阶段 → 发布
 3. 更新 RESEARCH.md 决策记录
 4. 更新 OVERVIEW.md 阶段列

package/.claude/skills/scout/template/product/INDEX.md

@@ -22,6 +22,11 @@
 | 搜索方式 | 关键词/图片 | 时间 | 结果数 | 数据文件 |
 |---------|-----------|------|--------|---------|
 
+## 卖家精灵数据（关键词/市场/广告）
+
+| 类型 | ASIN/关键词 | 时间 | 数据文件 |
+|------|-----------|------|---------|
+
 ## 数据关系
 
 {记录数据之间的关联，如：哪个供应商对应哪个竞品，哪些 ASIN 来自哪次搜索}

package/.claude/skills/scout/template/product/RESEARCH.md

@@ -15,7 +15,7 @@
 
 ## 阶段进度
 
-### 概念阶段（Charter 初版）
+### 概念阶段（产品立项书）
 - [ ] 趋势扫描（TikTok/Reddit/Twitter/Web Search 发现热度信号）
 - [ ] Amazon 市场扫描（关键词搜索覆盖）
 - [ ] 需求验证（月搜索量、BSR drops 估算月销）
@@ -25,7 +25,7 @@
 - [ ] IP/合规初筛（商标、专利、认证要求）
 - **CDCP Gate**: 市场够大？利润够高？竞争可打？无 IP 风险？
 
-### 计划阶段（Business Case）
+### 计划阶段（商业计划书）
 - [ ] 头部竞品深挖（TOP 3-5 产品详情）
 - [ ] $APPEALS 竞品评分（TOP 3-5 竞品 8 维度打分）
 - [ ] 用户痛点挖掘（差评聚类 → 差异化方向）
@@ -34,7 +34,7 @@
 - [ ] FAN 财务分析（单元经济、盈亏平衡、场景分析、回本周期）
 - [ ] 供应商初步接触（3-5 家询价、MOQ、交期）
 - [ ] 风险评估（竞争加剧、价格战、季节性、合规变化）
-- **PDCP Gate**: 有明确差异化？供应商可行？Business Case 成立？
+- **PDCP Gate**: 有明确差异化？供应商可行？商业计划书成立？
 
 ### 开发阶段（产品实现）
 - [ ] 供应商评估与选定（质量/交期/配合度/定制能力）
@@ -45,7 +45,7 @@
 - [ ] Listing 素材准备（图片、A+、视频）
 - **开发 Gate**: 样品达标？成本在预算内？Listing 就绪？
 
-### 验证阶段（Pre-launch）
+### 验证阶段（上线验证）
 - [ ] 第三方质检（AQL 抽检）
 - [ ] 小批量测试（50-100 件，验证转化率和退货率）
 - [ ] Listing A/B 测试（主图、标题变体）
@@ -60,7 +60,7 @@
 - [ ] 竞品动态监控
 
 ### 生命周期
-- [ ] 月度复盘（BSR/评论/竞品/利润 vs Business Case）
+- [ ] 月度复盘（BSR/评论/竞品/利润 vs 商业计划书）
 - [ ] 变体扩展评估
 - [ ] EOL 决策（何时退出）
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/optima-agent",
-  "version": "0.9.33",
+  "version": "0.9.35",
   "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
   "type": "module",
   "main": "dist/src/index.js",