@optima-chat/optima-agent 0.9.39 → 0.9.41

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

@@ -2,12 +2,12 @@
 
 ## 目标
 
-验证产品机会是否值得投入更多资源研究。产出产品立项书初版（即完成 RESEARCH.md 概念阶段所有 checklist 项）。
+验证产品机会是否值得投入更多资源研究。产出产品立项书初版（即完成项目页概念阶段所有 checklist 项）。
 
 ## 何时进入此阶段
 
 - 新建研究项目时自动进入
-- RESEARCH.md 当前阶段 = 概念
+- `wiki/entities/projects/{slug}.md` 当前阶段 = 概念
 
 ## 流程总览
 
@@ -45,9 +45,7 @@
 - Shein/Temu 发现低价爆品 → `scout search` 对比 Amazon 定价 → 判断品牌溢价空间
 - Reddit/Twitter 发现未满足需求 → `scout search` + `scout reviews` 验证痛点普遍性
 
-**落盘**：`data/social/{date}-{platform}.json` → 更新 `INDEX.md` + `market/MARKET.md`
-
-**完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）
+**完成标准**：至少查询 2 个平台，有明确热度信号（或确认无热度）。CLI 自动缓存所有 API 响应到 `~/.scout/cache/{project}/`。
 
 ---
 
@@ -76,9 +74,7 @@
 - 每个子品类标注：产品数量、价格区间、头部评论数、增长信号、竞争度
 - **子品类聚类是发现细分机会的关键步骤，不能跳过**
 
-**落盘**：`data/searches/{date}-{keyword}.json` + `data/sellersprite/{date}-{keyword}-mine.json` → 更新 `INDEX.md` + `market/MARKET.md`
-
-**完成标准**：覆盖 30+ 个不重复竞品，识别出 5+ 个子品类并标注各自规模
+**完成标准**：覆盖 30+ 个不重复竞品，识别出 5+ 个子品类并标注各自规模。CLI 自动缓存所有 API 响应。
 
 ---
 
@@ -92,9 +88,7 @@
 - `scout sp seller-countries <nodeIdPath>` — 获取卖家国籍分布
 - `scout sp seller-types <nodeIdPath>` — 获取 FBA/FBM/Amazon 自营占比
 
-**落盘**：`data/sellersprite/{date}-brands-{nodeIdPath}.json` 等 → 更新 `INDEX.md` + `market/MARKET.md`
-
-**完成标准**：有品牌集中度（CR3/CR5 量化数据）+ 卖家国籍分布 + FBA 占比
+**完成标准**：有品牌集中度（CR3/CR5 量化数据）+ 卖家国籍分布 + FBA 占比。CLI 自动缓存所有 API 响应。
 
 ---
 
@@ -106,9 +100,7 @@
 - `scout supplier-search "中文关键词" --limit 10` — 获取 1688 参考价
 - 记录：头部供应商价格区间、MOQ、供应商类型
 
-**落盘**：`data/suppliers/{date}-{keyword}.json` → 更新 `INDEX.md`
-
-**完成标准**：有 1688 参考价（至少 3 家供应商报价）
+**完成标准**：有 1688 参考价（至少 3 家供应商报价）。CLI 自动缓存所有 API 响应。
 
 ---
 
@@ -116,23 +108,30 @@
 
 **在做任何分析之前，必须通过以下检查。任何一项未通过 → 补数据，不分析。**
 
+使用 `scout cache list` 查看已缓存的文件列表。
+
 ```
 数据完整性检查清单：
 
-□ 搜索覆盖度：INDEX.md 中不重复 ASIN 数量 ≥ 30？
-□ 子品类聚类：MARKET.md 子品类分布表 ≥ 5 行？
-□ 精确搜索量：有 scout sp keywords-mine 数据（searches + purchases + bid）？
-□ 品牌集中度：有 scout sp brands 数据（CR3/CR5 + 份额）？
-□ 卖家国籍：有 scout sp seller-countries 数据？
-□ 供应端成本：有 1688 供应商报价（≥ 3 家）？
-□ 卖家类型：有 scout sp seller-types 数据（FBA/FBM 占比）？
-□ 趋势信号：有至少 2 个社交平台数据？
-□ 原始 JSON 落盘：data/ 目录文件数 ≥ 命令执行数？（每次命令都存了 JSON？）
-□ INDEX.md 一致：INDEX.md 中列出的文件在 data/ 目录中都存在？
+□ 搜索覆盖度：~/.scout/cache/{project}/ 中搜索结果文件包含 ≥ 30 个不重复 ASIN？
+□ 子品类聚类：完成后需在 ingest 时体现在 overview/market-{project}
+□ 精确搜索量：有 sp-keywords-mine 缓存文件？
+□ 品牌集中度：有 sp-brands 缓存文件？
+□ 卖家国籍：有 sp-seller-countries 缓存文件？
+□ 卖家类型：有 sp-seller-types 缓存文件？
+□ 供应端成本：有 supplier-search 缓存文件？
+□ 趋势信号：有至少 2 个社交平台缓存文件？
+□ 缓存完整：~/.scout/cache/{project}/ 文件数 ≥ 命令执行数？
+□ 全部 ingest：所有缓存文件已 ingest 到 KB（raw/ + wiki/sources/ 对应存在）？
 ```
 
 **如果有未通过的项，告知用户缺什么，补齐后重新检查。**
 
+检查通过后，批量 ingest 所有缓存文件到 ~/kb/product-research/：
+- 对每个缓存文件调用 kb-skills 的 ingesting-sources 流程
+- 确认 wiki/sources/ 中所有来源页已创建
+- 确认相关 entity 和 overview 页已更新
+
 **输出格式**：
 ```
 📋 数据完整性检查
@@ -143,8 +142,8 @@
 ❌ 卖家国籍：未采集 → 需要执行 scout sp seller-countries
 ✅ 供应端成本：5 家供应商报价
 ✅ 趋势信号：TikTok + Reddit
-✅ 原始 JSON：12/12 已落盘
-✅ INDEX.md 一致
+✅ 缓存完整：12/12 已缓存
+✅ 全部 ingest：已完成
 
 结论：2 项未通过，需要补充品牌集中度和卖家国籍数据。
 ```
@@ -168,11 +167,11 @@
   - 战略价值：品类协同、复购潜力
 - X 轴：竞争地位（1-5 分）
   - 差异化能力：子品类聚类中的空白机会
-  - 资金匹配度：对照 PROFILE.md
+  - 资金匹配度：对照 seller-profile.md
   - 供应链能力：1688 供应商数量和质量
   - 进入壁垒：用 `scout sp brands` 的品牌份额数据判断
 
-**落盘**：更新 `RESEARCH.md` SPAN 定位 + `market/MARKET.md` SPAN 评分
+**记录**：更新 `wiki/entities/projects/{slug}.md` SPAN 定位 + `wiki/overview/market-{slug}.md` SPAN 评分
 
 ---
 
@@ -188,9 +187,9 @@
 - 毛利 = 售价 - COGS - FBA 费
 - 粗略净利 = 毛利 - PPC 估算 - 退货估算
 
-**对照**：`PROFILE.md` 中的最低毛利率和最低净利率。如果 PROFILE 未填写，必须让用户确认。
+**对照**：`seller-profile.md` 中的最低毛利率和最低净利率。如果未填写，必须让用户确认。
 
-**落盘**：记录在 `RESEARCH.md` 关键发现中
+**记录**：更新 `wiki/entities/projects/{slug}.md` 关键发现
 
 ---
 
@@ -201,7 +200,7 @@
 **方法**：
 - Web Search 查询：商标（USPTO/WIPO）、外观专利、品类认证（FDA/FCC/UL/CPSIA）、Amazon 品类限制
 
-**落盘**：记录在 `RESEARCH.md` 关键发现中（如有风险则同时记入风险清单）
+**记录**：更新 `wiki/entities/projects/{slug}.md` 关键发现（如有风险则同时记入风险清单）
 
 ---
 
@@ -225,8 +224,8 @@
 3. 给出 **Go / Kill / Redirect** 建议
 4. 等待用户确认决策
 5. 确认后更新：
-   - `RESEARCH.md`（阶段 → 计划，记录决策）
-   - `OVERVIEW.md`（状态更新）
+   - `wiki/entities/projects/{slug}.md`（阶段 → 计划，记录决策）
+   - `index.md`（状态更新）
 
 ### 评审输出格式模板
 
@@ -260,22 +259,22 @@
 ### 各决策结果的具体操作
 
 **Go：**
-1. **生成产品立项书**，保存到 `reports/YYYY-MM-DD-产品立项书.md`。产品立项书必含：市场概况（含子品类分布）、SPAN 定位、竞争格局（含品牌集中度和卖家国籍）、初步利润估算（含 PPC）、机会与风险、Go 建议
-2. 更新 RESEARCH.md 当前阶段 → 计划
-3. 更新 RESEARCH.md 决策记录
-4. 更新 OVERVIEW.md 阶段列
-5. 更新 ROADMAP.md（该产品状态 → 已通过 CDCP）
+1. **生成产品立项书**，保存到 `wiki/analyses/{slug}-charter.md`。产品立项书必含：市场概况（含子品类分布）、SPAN 定位、竞争格局（含品牌集中度和卖家国籍）、初步利润估算（含 PPC）、机会与风险、Go 建议
+2. 更新 `wiki/entities/projects/{slug}.md` 当前阶段 → 计划
+3. 更新 `wiki/entities/projects/{slug}.md` 决策记录
+4. 更新 `index.md` 阶段列
+5. 更新 `wiki/overview/roadmap.md`（该产品状态 → 已通过 CDCP）
 6. 加载 planning.md 开始计划阶段
 
 **Kill：**
-1. 更新 RESEARCH.md 状态 → 已决策(No-Go)
-2. 更新 RESEARCH.md 决策记录（记录放弃原因）
-3. 更新 OVERVIEW.md：从活跃移到已完结
-4. 更新 ROADMAP.md（该产品状态 → 已放弃）
-5. 提示更新 CBB.md（即使失败也可能积累了有用信息）
+1. 更新 `wiki/entities/projects/{slug}.md` 状态 → 已决策(No-Go)
+2. 更新 `wiki/entities/projects/{slug}.md` 决策记录（记录放弃原因）
+3. 更新 `index.md`：从活跃移到已完结
+4. 更新 `wiki/overview/roadmap.md`（该产品状态 → 已放弃）
+5. 提示更新 `wiki/overview/cbb.md`（即使失败也可能积累了有用信息）
 
 **Redirect：**
-1. 更新 RESEARCH.md 决策记录（记录调整原因和新方向）
+1. 更新 `wiki/entities/projects/{slug}.md` 决策记录（记录调整原因和新方向）
 2. 根据调整幅度决定：
    - **小调整**（如从"无线耳机"缩窄到"开放式耳机"）：修改当前项目的研究目标，重置概念阶段 checklist 中受影响的项，重新执行
    - **大调整**（方向完全不同）：归档当前项目(No-Go)，新建项目重新开始
@@ -314,11 +313,15 @@ scout sp seller-types <nodeIdPath>
 scout supplier-search "钛合金杯子" --limit 10
 ```
 
-每个命令执行后立即落盘（JSON + INDEX.md）。
+CLI 自动缓存所有 API 响应到 `~/.scout/cache/{project}/`，无需手动落盘。
 
 **第二步：完整性检查**
 
-> "📋 数据完整性检查：9/9 全部通过。可以开始分析了。"
+使用 `scout cache list` 确认所有缓存文件存在。
+
+> "📋 数据完整性检查：10/10 全部通过。可以开始分析了。"
+
+检查通过后 ingest 所有缓存文件到 KB。
 
 **第三步：分析**
 

package/.claude/skills/scout/references/cross-project.md

@@ -10,8 +10,8 @@
 
 ## 数据获取
 
-1. 读取 ~/products/OVERVIEW.md 获取项目列表和状态
-2. 对每个相关项目读取 RESEARCH.md（SPAN、FAN、$APPEALS）
+1. 读取 ~/kb/product-research/index.md 获取项目列表和状态
+2. 对每个相关项目读取 wiki/entities/projects/{slug}.md（SPAN、FAN、$APPEALS）
 3. 如需详细对比，读取各项目活文档
 
 ## 分析类型
@@ -31,7 +31,7 @@
 
 ### 供应商资源复用
 
-检查各项目 data/suppliers/ 目录：
+检查各项目供应商数据（CLI 自动缓存在 ~/.scout/cache/{project}/）：
 - 同一供应商能否供多个产品
 - 合并采购的议价空间
 - 供应商地域风险分散
@@ -46,7 +46,7 @@
 
 CBB（Common Building Block，共用构建模块）是跨产品可复用的能力模块。
 
-**数据位置：** `~/products/CBB.md`
+**数据位置：** `~/kb/product-research/wiki/overview/cbb.md`
 
 **CBB 的 6 种类型：**
 
@@ -61,10 +61,10 @@ CBB（Common Building Block，共用构建模块）是跨产品可复用的能
 
 **何时更新 CBB：**
 - 项目完成（Go 或 No-Go）后，提示用户："这次研究积累了什么可复用的能力？"
-- 用户确认后更新 `~/products/CBB.md` 对应分类
+- 用户确认后更新 `~/kb/product-research/wiki/overview/cbb.md` 对应分类
 
 **何时查询 CBB：**
-- 新建项目时，读取 CBB.md 识别可复用能力
+- 新建项目时，读取 wiki/overview/cbb.md 识别可复用能力
 - 影响 SPAN 评分：有可复用的供应商/品类知识/品牌资产 → 竞争地位中"供应链能力"和"差异化能力"得分提升
 - 影响 FAN 模型：已有供应商关系可降低成本估算风险，已有物流线路可精确运费
 
@@ -74,6 +74,6 @@ CBB（Common Building Block，共用构建模块）是跨产品可复用的能
 
 ## 产出
 
-更新 ~/products/OVERVIEW.md "跨产品洞察"部分。
-如用户要求，生成 Portfolio 分析报告。
-项目完成后更新 ~/products/CBB.md 能力货架。
+更新 ~/kb/product-research/index.md "跨产品洞察"部分。
+如用户要求，生成 Portfolio 分析报告（保存到 wiki/analyses/）。
+项目完成后更新 ~/kb/product-research/wiki/overview/cbb.md 能力货架。

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

@@ -5,7 +5,7 @@
 
 ## 何时进入此阶段
 - PDCP Gate 通过后自动进入
-- RESEARCH.md 当前阶段 = 开发
+- wiki/entities/projects/{slug}.md 当前阶段 = 开发
 
 ## Scout 在此阶段的角色
 
@@ -14,46 +14,46 @@
 - **分析员**：用 FAN 模型验证成本变化对财务的影响
 - **提醒员**：追踪 checklist 进度，适时提醒 Gate 评审
 
-当用户汇报线下进展时，agent 帮助更新 RESEARCH.md 和相关文档。
+当用户汇报线下进展时，agent 帮助更新 wiki/entities/projects/{slug}.md 和相关文档。
 
 ## 执行步骤
 
 ### 1. 供应商评估与选定
 - 评估矩阵 7 维度（各 1-10 分）：产品质量、MOQ灵活性、交期可靠性、沟通配合度、定制能力、价格竞争力、认证资质
 - 建议选 2 家（主选+备选）
-- 更新 suppliers/SUPPLIERS.md 评估矩阵
+- 更新 wiki/overview/suppliers-{slug}.md 评估矩阵
 
 ### 2. 成本模型定稿
 - 用实际报价替换计划阶段估算
-- 更新 RESEARCH.md FAN 财务模型
+- 更新 wiki/entities/projects/{slug}.md FAN 财务模型
 - 重新计算场景分析
 
 ### 3. 产品规格确认
 - 材料、尺寸重量（影响FBA费分级）、包装、颜色/变体、认证清单
-- **落盘位置**：记录在 RESEARCH.md 关键发现中
+- **更新页面**：记录在 wiki/entities/projects/{slug}.md 关键发现中
 
 ### 4. 样品迭代
 - 至少 2 轮（基础功能确认 → 修改后最终确认）
 - 记录每轮问题和修改
-- **落盘位置**：记录在 RESEARCH.md 关键发现中（每轮追加）
+- **更新页面**：记录在 wiki/entities/projects/{slug}.md 关键发现中（每轮追加）
 
 ### 5. 包装设计
 - 品牌包装、FBA 尺寸优化、内包装保护、Insert card
-- **落盘位置**：记录在 RESEARCH.md 关键发现中
+- **更新页面**：记录在 wiki/entities/projects/{slug}.md 关键发现中
 
 ### 6. Listing 素材准备
 - 主图+6副图、A+ Content、视频（可选）、关键词列表
-- **落盘位置**：记录在 RESEARCH.md 关键发现中（可附注素材链接）
+- **更新页面**：记录在 wiki/entities/projects/{slug}.md 关键发现中（可附注素材链接）
 
 ## 开发 Gate 评审
 
 5 个问题：样品达标？成本在预算内？认证已获得？Listing就绪？供应商可承诺批量交期？
 
 **Go（全 Yes）：**
-1. **生成产品规格书 + 供应商评估报告**，保存到 `reports/YYYY-MM-DD-产品规格书.md`
-2. 更新 RESEARCH.md 当前阶段 → 验证
-3. 更新 RESEARCH.md 决策记录
-4. 更新 OVERVIEW.md 阶段列
-5. 更新 ROADMAP.md（状态 → 已通过开发 Gate）
+1. **生成产品规格书 + 供应商评估报告**，保存到 `wiki/analyses/YYYY-MM-DD-产品规格书.md`
+2. 更新 wiki/entities/projects/{slug}.md 当前阶段 → 验证
+3. 更新 wiki/entities/projects/{slug}.md 决策记录
+4. 更新 index.md 阶段列
+5. 更新 wiki/overview/roadmap.md（状态 → 已通过开发 Gate）
 
 **不通过：** 标注具体不达标项，回到对应步骤修正后重新评审

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

@@ -5,7 +5,7 @@
 
 ## 何时进入此阶段
 - ADCP Gate 通过后进入
-- RESEARCH.md 当前阶段 = 发布
+- wiki/entities/projects/{slug}.md 当前阶段 = 发布
 
 ## 关键活动
 

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

@@ -5,7 +5,7 @@
 
 ## 何时进入此阶段
 - 产品正式上架并稳定销售后
-- RESEARCH.md 当前阶段 = 生命周期
+- wiki/entities/projects/{slug}.md 当前阶段 = 生命周期
 
 ## 关键活动
 
@@ -28,12 +28,12 @@
 
 ### EOL 决策（LDCP）
 退出信号：
-- 连续 3 月利润低于 PROFILE.md 最低净利率
+- 连续 3 月利润低于 wiki/entities/seller-profile.md 最低净利率
 - BSR 持续恶化无改善
 - ACoS 不可控
 - 库存积压超 6 月周转
 
-EOL 后：清仓策略 → 更新 RESEARCH.md 状态(No-Go) → 更新 OVERVIEW.md 移入已完结
+EOL 后：清仓策略 → 更新 wiki/entities/projects/{slug}.md 状态(No-Go) → 更新 index.md 移入已完结
 
 ## Scout 在此阶段的作用
 定期手动复查数据，更新月度对比。未来可通过定时任务自动化。

package/.claude/skills/scout/references/market-management.md

@@ -2,19 +2,19 @@
 
 ## 目标
 
-MM 是产品开发的前置流程，负责"做正确的事"。通过系统化的市场扫描和机会评估，确定未来的选品方向和优先级，输出产品路标规划（ROADMAP.md）。
+MM 是产品开发的前置流程，负责"做正确的事"。通过系统化的市场扫描和机会评估，确定未来的选品方向和优先级，输出产品路标规划（wiki/overview/roadmap.md）。
 
 ## 何时触发
 
 - 用户问"接下来做什么品类？"、"年度选品方向"、"产品线规划"
 - 季度复盘时主动建议
-- 首次使用且 ROADMAP.md 为空时
+- 首次使用且 wiki/overview/roadmap.md 为空时
 - 用户要求"帮我扫描一下市场机会"
 
 ## 与概念阶段的关系
 
-- MM 产出的是**方向和机会清单**（ROADMAP.md 品类机会池）
-- 概念阶段针对**具体产品**做深入验证（RESEARCH.md）
+- MM 产出的是**方向和机会清单**（wiki/overview/roadmap.md 品类机会池）
+- 概念阶段针对**具体产品**做深入验证（wiki/entities/projects/{slug}.md）
 - MM 是宏观选择（做哪个品类），概念是微观验证（这个具体产品行不行）
 - MM 可以同时评估 5-10 个方向，概念阶段一次专注 1 个产品
 
@@ -25,8 +25,8 @@ MM 是产品开发的前置流程，负责"做正确的事"。通过系统化的
 **目的：** 明确本次 MM 要探索的方向。
 
 **输入来源：**
-- PROFILE.md 中的偏好品类和回避品类
-- CBB.md 中已有能力可延伸的品类
+- wiki/entities/seller-profile.md 中的偏好品类和回避品类
+- wiki/overview/cbb.md 中已有能力可延伸的品类
 - 用户提出的兴趣方向
 - 外部趋势信号（社交媒体热度、行业新闻）
 
@@ -61,7 +61,7 @@ scout tiktok search-videos "品类关键词"
 **方法：** 参考 analysis-framework.md 的 SPAN 评分标准，但允许粗略估算：
 
 - 市场吸引力（1-5）：基于步骤 2 收集的市场规模和增长信号
-- 竞争地位（1-5）：基于 PROFILE.md 能力 + CBB.md 可复用资源
+- 竞争地位（1-5）：基于 wiki/entities/seller-profile.md 能力 + wiki/overview/cbb.md 可复用资源
 
 **产出：** 每个方向一个 SPAN 坐标 + 象限判断
 
@@ -72,21 +72,21 @@ scout tiktok search-videos "品类关键词"
 **排序依据（权重递减）：**
 
 1. **SPAN 象限**：投资 > 选择性投入 > 收割 > 退出
-2. **与 PROFILE.md 匹配度**：价位区间、品类偏好、风险偏好
-3. **CBB 复用度**：能从能力货架取用多少现有模块？复用越多风险越低
+2. **与 seller-profile 匹配度**：价位区间、品类偏好、风险偏好
+3. **CBB 复用度**：能从能力货架（wiki/overview/cbb.md）取用多少现有模块？复用越多风险越低
 4. **时间窗口**：是否有季节性或趋势紧迫性？
 
 **优先级分类：**
 - **P1**：SPAN 投资象限 + 高匹配 + 有 CBB 复用 → 立即立项研究
 - **P2**：SPAN 投资/选择性投入 + 中匹配 → 排队等资源
 - **P3**：有潜力但需补强或时机未到 → 持续观察
-- **放弃**：SPAN 退出象限 / 与 PROFILE 不匹配 / 无法补强
+- **放弃**：SPAN 退出象限 / 与 seller-profile 不匹配 / 无法补强
 
 ---
 
 ### 5. 更新产品路标
 
-**更新 `~/products/ROADMAP.md`：**
+**更新 `~/kb/product-research/wiki/overview/roadmap.md`：**
 - 品类机会池：添加新机会，标注优先级和 SPAN 评分
 - 产品线规划：P1 机会排入时间线
 - 资源预算分配：根据优先级分配预算
@@ -96,14 +96,14 @@ scout tiktok search-videos "品类关键词"
 
 ### 6. 生成品类分析报告
 
-**生成品类分析报告**，保存到 `~/products/reports/YYYY-MM-DD-品类分析报告.md`。
+**生成品类分析报告**，保存到 `~/kb/product-research/wiki/analyses/YYYY-MM-DD-品类分析报告.md`。
 
 必含章节：
 - 扫描范围（评估了哪些品类方向）
 - 各品类 SPAN 评分（市场吸引力 + 竞争地位）
 - 优先级排序结果（P1/P2/P3/放弃）及理由
-- 与 PROFILE.md 的匹配度分析
-- CBB 复用度评估
+- 与 seller-profile 的匹配度分析
+- CBB 复用度评估（wiki/overview/cbb.md）
 - 最终选择的方向和下一步行动
 
 ---
@@ -111,13 +111,13 @@ scout tiktok search-videos "品类关键词"
 ### 7. 立项触发
 
 **P1 机会 → 发起概念阶段：**
-- 从 ROADMAP.md 选取 P1 机会
-- 创建新项目（template/product/ → ~/products/{slug}/）
+- 从 wiki/overview/roadmap.md 选取 P1 机会
+- 创建新项目（wiki/entities/projects/{slug}.md）
 - 进入概念阶段深入验证
 
 **控制节奏：**
 - 同时进行中的概念/计划阶段项目不宜超过 3 个（避免资源分散）
-- 参考 PROFILE.md 单品启动预算和总资金情况
+- 参考 wiki/entities/seller-profile.md 单品启动预算和总资金情况
 
 ## MM 复盘节奏
 
@@ -131,4 +131,4 @@ scout tiktok search-videos "品类关键词"
 
 - MM 负责**输入端**：发现新机会，决定做什么
 - Portfolio 负责**管理端**：已立项产品的资源分配和 Go/Kill 决策
-- 两者共享 SPAN 框架和 ROADMAP.md
+- 两者共享 SPAN 框架和 wiki/overview/roadmap.md

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

@@ -7,7 +7,7 @@
 ## 何时进入此阶段
 
 - CDCP Gate 通过后自动进入
-- RESEARCH.md 当前阶段 = 计划
+- `wiki/entities/projects/{slug}.md` 当前阶段 = 计划
 
 ## 执行步骤
 
@@ -46,7 +46,7 @@
 
 - 这张表反映竞品的运营成熟度，A+ 和视频覆盖率高 = 竞争壁垒高
 
-**落盘位置**：`data/products/{ASIN}.json` + `data/sellersprite/{ASIN}-predict.json` → 更新 `INDEX.md` + `competitors/COMPETITORS.md`
+**更新页面**：`wiki/overview/competition-{slug}.md`
 
 **完成标准**：5-8 个竞品有完整数据（产品详情 + 流量关键词 + 历史销量 + Listing 能力）
 
@@ -72,7 +72,7 @@
 - 差异化公式：用户在乎 × 竞品弱 = 机会
 - 可选：`scout sp keywords <ASIN>` 的 badges 字段可判断竞品是否投了广告（含 "ads" = 有投放），辅助评估竞品的广告投入力度
 
-**落盘位置**：更新 `RESEARCH.md` $APPEALS 评分卡 + `competitors/COMPETITORS.md`
+**更新页面**：`wiki/entities/projects/{slug}.md` $APPEALS 评分卡 + `wiki/overview/competition-{slug}.md`
 
 **完成标准**：≥3 竞品完成 8 维度打分，识别出差异化方向
 
@@ -91,7 +91,7 @@
 - 评估改进可行性（技术难度、成本影响）
 - 同时分析好评高频词（判断维度权重）
 
-**落盘位置**：`data/reviews/{ASIN}-{star}.json` → 更新 `INDEX.md` + `reviews/PAIN-POINTS.md`
+**更新页面**：`wiki/overview/pain-points-{slug}.md`
 
 **推荐补充**：`scout sp keywords-order <ASIN>` 反查竞品出单词（哪些关键词真正带来转化），区分流量词和出单词，找到竞品的核心转化路径
 
@@ -116,7 +116,7 @@
 - 成熟期：BSR 平稳 + 评论稳定增长 + 价格竞争加剧
 - 衰退期：BSR 上升 + 评论增速放缓 + 卖家数减少
 
-**落盘位置**：`data/keepa/{date}-batch.json` → 更新 `INDEX.md` + `trends/TRENDS.md`
+**更新页面**：`wiki/overview/trends-{slug}.md`
 
 **完成标准**：有 Keepa 数据，判断了生命周期
 
@@ -133,7 +133,7 @@
 - 定价策略（基于竞品定价分布和差异化溢价）
 - 目标客群画像
 
-**落盘位置**：更新 `competitors/COMPETITORS.md` 差异化机会总结
+**更新页面**：`wiki/overview/competition-{slug}.md` 差异化机会总结
 
 **完成标准**：有明确策略可传达给供应商
 
@@ -141,7 +141,7 @@
 
 **目的**：验证产品财务可行性，确认利润空间
 
-**前置检查**：读取 `~/products/PROFILE.md` 的决策标准（最低毛利率、最低净利率）。如果 PROFILE 未填写这些阈值，**必须先让用户确认**："你的最低可接受净利率是多少？（默认 30%）"——否则 PDCP Gate 无法判断。
+**前置检查**：读取决策标准（最低毛利率、最低净利率）。如果未填写这些阈值，**必须先让用户确认**："你的最低可接受净利率是多少？（默认 30%）"——否则 PDCP Gate 无法判断。
 
 **具体命令**：
 - `scout supplier-search "关键词" --limit 20`（文字搜索供应商）
@@ -164,7 +164,7 @@
 - 盈亏平衡点
 - 回本周期
 
-**落盘位置**：`data/suppliers/{date}-keyword.json` → 更新 `INDEX.md` + `RESEARCH.md` FAN + `suppliers/SUPPLIERS.md`
+**更新页面**：`wiki/entities/projects/{slug}.md` FAN 部分 + `wiki/overview/suppliers-{slug}.md`
 
 **完成标准**：单元经济完整，有场景分析
 
@@ -181,7 +181,7 @@
   - 定制能力（能否实现差异化设计）
   - 价格（阶梯报价、含税含运）
 
-**落盘位置**：更新 `suppliers/SUPPLIERS.md` TOP 供应商对比表
+**更新页面**：`wiki/overview/suppliers-{slug}.md` TOP 供应商对比表
 
 **完成标准**：至少 1 家可行（MOQ/交期/价格可接受）
 
@@ -201,7 +201,7 @@
 - 评估发生概率（高/中/低）
 - 制定应对方案（规避/转移/减轻/接受）
 
-**落盘位置**：更新 `RESEARCH.md` 风险清单
+**更新页面**：`wiki/entities/projects/{slug}.md` 风险清单
 
 **完成标准**：主要风险识别，每个有应对方案
 
@@ -212,19 +212,20 @@
 ```
 计划阶段数据完整性检查清单：
 
-□ 竞品深度：5-8 个竞品有完整 product detail？
-□ 流量关键词：5-8 个竞品有 scout sp keywords 数据？
-□ 历史销量：5-8 个竞品有 scout sp predict 14 个月数据？
-□ 季节性分析：COMPETITORS.md 季节性分析表已填写？
-□ Listing 能力矩阵：COMPETITORS.md 能力矩阵表已填写？
+□ 竞品深度：5-8 个竞品有 product 缓存文件？
+□ 流量关键词：5-8 个竞品有 sp-keywords 缓存文件？
+□ 历史销量：5-8 个竞品有 sp-predict 缓存文件？
+□ 季节性分析：wiki/overview/competition-{slug}.md 季节性分析已更新？
+□ Listing 能力矩阵：wiki/overview/competition-{slug}.md 能力矩阵表已填写？
 □ $APPEALS 评分：≥ 3 个竞品完成 8 维度打分？
 □ 差评分析：≥ 30 条差评已聚类？
 □ Keepa 趋势：有 180 天 BSR 趋势 + 生命周期判断？
 □ FAN 模型：单元经济 + 4 场景分析完整？（含真实 PPC 竞价）
 □ 供应商：≥ 1 家可行供应商？
-□ 差异化策略：COMPETITORS.md 差异化机会总结已填写？
+□ 差异化策略：wiki/overview/competition-{slug}.md 差异化机会总结已填写？
 □ 风险清单：主要风险已识别且有应对方案？
-□ 原始 JSON 落盘：所有命令结果已存到 data/？
+□ 缓存完整：~/.scout/cache/{project}/ 文件数 ≥ 命令执行数？
+□ 全部 ingest：所有缓存文件已 ingest 到 KB？
 ```
 
 ## PDCP Gate 评审
@@ -239,7 +240,7 @@
 |---|------|----------|
 | 1 | 差异化明确？ | $APPEALS 至少 2 个维度领先竞品均值 2+ 分 |
 | 2 | 供应商可行？ | 至少 1 家通过评估（MOQ/交期/价格可接受） |
-| 3 | 财务成立？ | FAN 基准净利率 ≥ PROFILE 最低净利率，悲观场景不亏损 |
+| 3 | 财务成立？ | FAN 基准净利率 ≥ seller-profile 最低净利率，悲观场景不亏损 |
 | 4 | 风险可控？ | 无致命风险，每个已识别风险有应对方案 |
 | 5 | 时间窗口？ | 非衰退期，趋势向上或平稳 |
 
@@ -273,13 +274,13 @@
 ### Go/Kill/Redirect 标准及操作
 
 **Go（5 项全部通过）：**
-1. **生成商业计划书**，保存到 `reports/YYYY-MM-DD-商业计划书.md`。必含：$APPEALS 对比、痛点与差异化策略、Keepa 趋势、FAN 财务模型（含场景分析）、供应商评估、风险清单、进入策略
-2. 更新 RESEARCH.md 当前阶段 → 开发
-3. 更新 RESEARCH.md 决策记录
-4. 更新 OVERVIEW.md 阶段列
-5. 更新 ROADMAP.md（状态 → 已通过 PDCP）
+1. **生成商业计划书**，保存到 `wiki/analyses/{slug}-business-case.md`。必含：$APPEALS 对比、痛点与差异化策略、Keepa 趋势、FAN 财务模型（含场景分析）、供应商评估、风险清单、进入策略
+2. 更新 `wiki/entities/projects/{slug}.md` 当前阶段 → 开发
+3. 更新 `wiki/entities/projects/{slug}.md` 决策记录
+4. 更新 `index.md` 阶段列
+5. 更新 `wiki/overview/roadmap.md`（状态 → 已通过 PDCP）
 6. 加载 development.md 开始开发阶段
 
-**Kill：** 财务不成立/致命风险/差异化不足 → 终止项目，更新 RESEARCH.md(No-Go) + OVERVIEW.md(已完结) + ROADMAP.md(已放弃) + CBB.md
+**Kill：** 财务不成立/致命风险/差异化不足 → 终止项目，更新 `wiki/entities/projects/{slug}.md`(No-Go) + `index.md`(已完结) + `wiki/overview/roadmap.md`(已放弃) + `wiki/overview/cbb.md`
 
 **Redirect：** 部分通过但有改进路径 → 调整方向后重新评估（记录调整内容和重评时间）