@optima-chat/optima-agent 0.9.24 → 0.9.26

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

@@ -86,24 +86,26 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
 
 ### 落盘映射
 
-| 命令 | 存储位置 | JSON 文件 | 更新的活文档 |
-|------|---------|----------|------------|
-| `scout search` | market/ | searches.json | MARKET.md |
-| `scout tiktok *` | market/ | tiktok.json | MARKET.md |
-| `scout reddit *` | market/ | reddit.json | MARKET.md |
-| `scout twitter *` | market/ | twitter.json | MARKET.md |
-| `scout instagram *` | market/ | instagram.json | MARKET.md |
-| `scout douyin *` | market/ | douyin.json | MARKET.md |
-| `scout xhs *` | market/ | xhs.json | MARKET.md |
-| `scout shein-search` | market/ | shein.json | MARKET.md |
-| `scout temu-search` | market/ | temu.json | MARKET.md |
-| `scout taobao *` | market/ | taobao.json | MARKET.md |
-| Web Search | market/ | web-research.json | MARKET.md |
-| `scout product` | competitors/ | {ASIN}.json | COMPETITORS.md |
-| `scout reviews` | reviews/ | {ASIN}-reviews.json | PAIN-POINTS.md |
-| `scout keepa product` | trends/ | keepa-data.json | TRENDS.md |
-| `scout supplier-search` | suppliers/ | suppliers.json | SUPPLIERS.md |
-| `scout supplier-search-image` | suppliers/ | suppliers.json | SUPPLIERS.md |
+| 命令 | JSON 文件 | 更新的活文档 |
+|------|----------|------------|
+| `scout search` | market/searches.json | market/MARKET.md |
+| `scout tiktok *` | market/tiktok.json | market/MARKET.md |
+| `scout reddit *` | market/reddit.json | market/MARKET.md |
+| `scout twitter *` | market/twitter.json | market/MARKET.md |
+| `scout instagram *` | market/instagram.json | market/MARKET.md |
+| `scout douyin *` | market/douyin.json | market/MARKET.md |
+| `scout xhs *` | market/xhs.json | market/MARKET.md |
+| `scout shein-search` | market/shein.json | market/MARKET.md |
+| `scout temu-search` | market/temu.json | market/MARKET.md |
+| `scout taobao *` | market/taobao.json | market/MARKET.md |
+| Web Search | market/web-research.json | market/MARKET.md |
+| `scout product` | competitors/{ASIN}.json | competitors/COMPETITORS.md |
+| `scout reviews` | reviews/{ASIN}-reviews.json | reviews/PAIN-POINTS.md |
+| `scout keepa product` | trends/keepa-data.json | trends/TRENDS.md |
+| `scout supplier-search` | suppliers/suppliers.json | suppliers/SUPPLIERS.md |
+| `scout supplier-search-image` | suppliers/suppliers.json | suppliers/SUPPLIERS.md |
+
+**注意**：所有路径相对于项目目录 `~/products/{slug}/`。不要在其他目录创建文件。
 
 ### JSON 格式
 

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

@@ -53,7 +53,7 @@
 - "bought in past month" 频率（需求热度）
 - 品牌重复度（垄断程度）
 
-**落盘位置**：`market/searches.json` → 更新 `MARKET.md`
+**落盘位置**：`market/searches.json` → 更新 `market/MARKET.md`
 
 **完成标准**：2-3 组关键词搜索覆盖主要同义词
 
@@ -73,7 +73,7 @@
 - salesRankDrops（Keepa 销量掉落次数 ≈ 出单次数）
 - "bought in past month" 具体数值
 
-**落盘位置**：更新 `MARKET.md` 需求验证部分
+**落盘位置**：更新 `market/MARKET.md` 需求验证部分
 
 **完成标准**：有具体月销量估算数据
 
@@ -90,7 +90,7 @@
 - 品牌集中度（CR3/CR5）
 - 参考 `metrics.md` 竞争指标表
 
-**落盘位置**：更新 `MARKET.md` 竞争格局部分
+**落盘位置**：更新 `market/MARKET.md` 竞争格局部分
 
 **完成标准**：知道竞品数量、头部评论数、是否品牌垄断
 
@@ -109,7 +109,7 @@
 
 **注意**：概念阶段是初步评估，部分维度可以粗略打分，后续阶段再精确
 
-**落盘位置**：更新 `RESEARCH.md` SPAN 定位 + `MARKET.md` SPAN 评分
+**落盘位置**：更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
 
 **完成标准**：两个维度都有评分
 

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

@@ -21,7 +21,7 @@
 ### 1. 供应商评估与选定
 - 评估矩阵 7 维度（各 1-10 分）：产品质量、MOQ灵活性、交期可靠性、沟通配合度、定制能力、价格竞争力、认证资质
 - 建议选 2 家（主选+备选）
-- 更新 SUPPLIERS.md 评估矩阵
+- 更新 suppliers/SUPPLIERS.md 评估矩阵
 
 ### 2. 成本模型定稿
 - 用实际报价替换计划阶段估算
@@ -46,5 +46,14 @@
 - **落盘位置**：记录在 RESEARCH.md 关键发现中（可附注素材链接）
 
 ## 开发 Gate 评审
+
 5 个问题：样品达标？成本在预算内？认证已获得？Listing就绪？供应商可承诺批量交期？
-全 Yes → Go（下首批订单，进入验证阶段）
+
+**Go（全 Yes）：**
+1. **生成产品规格书 + 供应商评估报告**，保存到 `reports/YYYY-MM-DD-产品规格书.md`
+2. 更新 RESEARCH.md 当前阶段 → 验证
+3. 更新 RESEARCH.md 决策记录
+4. 更新 OVERVIEW.md 阶段列
+5. 更新 ROADMAP.md（状态 → 已通过开发 Gate）
+
+**不通过：** 标注具体不达标项，回到对应步骤修正后重新评审

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

@@ -32,7 +32,7 @@
 - A+ 页面有无及质量
 - 变体布局（颜色/尺寸/套装）
 
-**落盘位置**：`competitors/{ASIN}.json` → 更新 `COMPETITORS.md`
+**落盘位置**：`competitors/{ASIN}.json` → 更新 `competitors/COMPETITORS.md`
 
 **完成标准**：3-5 个竞品有完整数据
 
@@ -57,7 +57,7 @@
 - 识别集体弱项（差评聚类 → 竞品普遍做不好什么）
 - 差异化公式：用户在乎 × 竞品弱 = 机会
 
-**落盘位置**：更新 `RESEARCH.md` $APPEALS 评分卡 + `COMPETITORS.md`
+**落盘位置**：更新 `RESEARCH.md` $APPEALS 评分卡 + `competitors/COMPETITORS.md`
 
 **完成标准**：≥3 竞品完成 8 维度打分，识别出差异化方向
 
@@ -76,7 +76,7 @@
 - 评估改进可行性（技术难度、成本影响）
 - 同时分析好评高频词（判断维度权重）
 
-**落盘位置**：`reviews/{ASIN}-reviews.json` → 更新 `PAIN-POINTS.md`
+**落盘位置**：`reviews/{ASIN}-reviews.json` → 更新 `reviews/PAIN-POINTS.md`
 
 **完成标准**：≥30 条差评分析，形成 3+ 个痛点聚类
 
@@ -99,7 +99,7 @@
 - 成熟期：BSR 平稳 + 评论稳定增长 + 价格竞争加剧
 - 衰退期：BSR 上升 + 评论增速放缓 + 卖家数减少
 
-**落盘位置**：`trends/keepa-data.json` → 更新 `TRENDS.md`
+**落盘位置**：`trends/keepa-data.json` → 更新 `trends/TRENDS.md`
 
 **完成标准**：有 Keepa 数据，判断了生命周期
 
@@ -116,7 +116,7 @@
 - 定价策略（基于竞品定价分布和差异化溢价）
 - 目标客群画像
 
-**落盘位置**：更新 `COMPETITORS.md` 差异化机会总结
+**落盘位置**：更新 `competitors/COMPETITORS.md` 差异化机会总结
 
 **完成标准**：有明确策略可传达给供应商
 
@@ -146,7 +146,7 @@
 - 盈亏平衡点
 - 回本周期
 
-**落盘位置**：`suppliers/suppliers.json` → 更新 `RESEARCH.md` FAN + `SUPPLIERS.md`
+**落盘位置**：`suppliers/suppliers.json` → 更新 `RESEARCH.md` FAN + `suppliers/SUPPLIERS.md`
 
 **完成标准**：单元经济完整，有场景分析
 
@@ -163,7 +163,7 @@
   - 定制能力（能否实现差异化设计）
   - 价格（阶梯报价、含税含运）
 
-**落盘位置**：更新 `SUPPLIERS.md` TOP 供应商对比表
+**落盘位置**：更新 `suppliers/SUPPLIERS.md` TOP 供应商对比表
 
 **完成标准**：至少 1 家可行（MOQ/交期/价格可接受）
 

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

@@ -43,9 +43,17 @@
 - 前 10-20 条评论（`scout reviews MY_ASIN --pages 2`）
 - 正面是否验证差异化？负面有无预期外问题？
 - 参考 requirements.md 的"验证"步骤做需求满足度确认
-- **落盘位置**：reviews/{MY_ASIN}-reviews.json + 更新 PAIN-POINTS.md
+- **落盘位置**：reviews/{MY_ASIN}-reviews.json + 更新 reviews/PAIN-POINTS.md
 
 ## ADCP Gate 评审
+
 5个问题：质量达标？转化≥品类平均且退货<5%？Listing就绪？ACoS在FAN假设±20%内？库存和资金就位？
-全 Yes → Go（追加库存，正式 Launch）
-不达标 → 回开发阶段修正
+
+**Go（全 Yes）：**
+1. **生成 Pre-launch 验证报告**，保存到 `reports/YYYY-MM-DD-验证报告.md`。必含：质检结果、转化率/退货率实测数据、ACoS 实际 vs FAN 预估对比、首批评论分析、上线就绪度判断
+2. 更新 RESEARCH.md 当前阶段 → 发布
+3. 更新 RESEARCH.md 决策记录
+4. 更新 OVERVIEW.md 阶段列
+5. 更新 ROADMAP.md（状态 → 已通过 ADCP）
+
+**不达标：** 标注具体问题，回开发阶段修正后重新评审

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

@@ -26,7 +26,7 @@
 - `scout product` 竞品 Feature Bullets（竞品已满足的需求）
 - Web Search 行业报告、论坛帖子
 
-**收集产出：** PAIN-POINTS.md 中的痛点聚类表和好评亮点表
+**收集产出：** reviews/PAIN-POINTS.md 中的痛点聚类表和好评亮点表
 
 ---
 
@@ -37,7 +37,7 @@
 - 差评聚类 → 痛点频率统计
 - 好评高频词 → 用户最在乎什么
 
-**分析产出：** COMPETITORS.md 中的差异化机会总结
+**分析产出：** competitors/COMPETITORS.md 中的差异化机会总结
 
 ---
 
@@ -58,7 +58,7 @@
 - 竞品在该维度的得分（竞品普遍弱 = 差异化机会大）
 
 **可行性评估依据：**
-- 供应商是否能实现？（已在 SUPPLIERS.md 中确认）
+- 供应商是否能实现？（已在 suppliers/SUPPLIERS.md 中确认）
 - 成本增加多少？（对 FAN 模型的影响）
 - 是否需要新模具/认证？（时间和资金成本）
 

package/package.json

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