@optima-chat/optima-agent 0.9.54 → 0.9.56

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

@@ -8,7 +8,7 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/k
 ## 启动 SOP
 
 1. 检查 `~/kb/product-research/` 是否存在
-   - 不存在 → 使用 kb-skills 的 initializing-kb 流程创建，**KB 名称必须是 `product-research`**，不要复用其他已有 KB。用 `cp` 命令将 `template/kb/` 下的模板文件复制到 KB 对应位置（AGENTS.md、wiki/entities/seller-profile.md、wiki/overview/roadmap.md、wiki/overview/cbb.md）。
+   - 不存在 → 执行 `Skill("initializing-kb")` 创建 KB，**名称必须是 `product-research`**，不要复用其他已有 KB。用 `cp` 命令将 `template/kb/` 下的模板文件复制到 KB 对应位置（AGENTS.md、wiki/entities/seller-profile.md、wiki/overview/roadmap.md、wiki/overview/cbb.md）。
    - **必须询问用户填写 `wiki/entities/seller-profile.md` 的关键字段**（至少：主营市场、目标价位、最低毛利率、最低净利率、单品启动预算）。**严格使用用户回答的数值，不要自行调整。**
 2. 检查 `wiki/entities/seller-profile.md` 是否已填写关键字段
    - 未填写 → 必须询问（不能跳过关键字段：最低毛利率、最低净利率、单品启动预算）
@@ -90,8 +90,8 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/k
 数据采集完成后，必须将缓存文件 ingest 到 KB 才能进入分析。步骤：
 
 1. `cp ~/.scout/cache/{project}/*.json ~/kb/product-research/raw/`
-2. 对每个 raw/ 文件，使用 Skill 工具调用 `ingesting-sources` skill — 它会创建 source 页并输出受影响页面清单
-3. 使用 Skill 工具调用 `updating-related-pages` skill — 它会根据清单更新 entity/overview 页面
+2. 执行 `Skill("ingesting-sources")` 加载收录技能，对每个 raw/ 文件执行收录流程（创建 source 页 + 输出受影响页面清单）
+3. 执行 `Skill("updating-related-pages")` 加载更新技能，根据清单更新 entity/overview 页面
 4. 运行 `ls ~/kb/product-research/raw/` 和 `ls ~/kb/product-research/wiki/sources/` 确认文件已生成
 
 ### 分析数据来源

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

@@ -108,7 +108,10 @@
 
 ### Ingest
 
-按 SKILL.md「Ingest（缓存数据收录到 KB）」章节的步骤，将所有缓存文件收录到 KB。
+1. `cp ~/.scout/cache/{project}/*.json ~/kb/product-research/raw/`
+2. 执行 `Skill("ingesting-sources")` 对每个 raw/ 文件创建 source 页
+3. 执行 `Skill("updating-related-pages")` 更新 entity/overview 页
+4. `ls ~/kb/product-research/wiki/sources/` 确认来源页已生成
 
 ### 数据完整性检查
 
@@ -153,14 +156,14 @@
 
 **前置条件：必须先运行 `ls ~/kb/product-research/wiki/sources/` 确认来源页不为空。如果为空，说明 ingest 未完成，必须返回第二步。**
 
-**所有分析数据必须使用 Skill 工具调用 `querying-the-wiki` skill 从 KB 查询，禁止直接读 `~/.scout/cache/` 中的 JSON 文件。**
+**所有分析数据必须通过 `Skill("querying-the-wiki")` 从 KB 查询，禁止直接读 `~/.scout/cache/` 中的 JSON 文件。**
 
 ### 5. SPAN 初步定位
 
 **目的**：战略定位评估
 
 **方法**：
-- 用 `querying-the-wiki` skill 查询：子品类分布、精确搜索量、品牌集中度、卖家画像
+- 通过 `Skill("querying-the-wiki")` 查询：子品类分布、精确搜索量、品牌集中度、卖家画像
 - 参考 `analysis-framework.md` SPAN 评分标准
 - Y 轴：市场吸引力（1-5 分）— 市场规模、增长趋势、利润潜力、战略价值
 - X 轴：竞争地位（1-5 分）— 差异化能力、资金匹配度、供应链能力、进入壁垒
@@ -174,7 +177,7 @@
 **目的**：粗算利润空间
 
 **方法**：
-- 用 `querying-the-wiki` skill 查询：Amazon 均价、1688 参考价、PPC 竞价数据、卖家画像的利润阈值
+- 通过 `Skill("querying-the-wiki")` 查询：Amazon 均价、1688 参考价、PPC 竞价数据、卖家画像的利润阈值
 - 毛利 = 售价 - COGS - FBA 费
 - 粗略净利 = 毛利 - PPC 估算 - 退货估算
 
@@ -306,13 +309,13 @@ CLI 自动缓存所有 API 响应到 `~/.scout/cache/{project}/`，无需手动
 
 **第二步：Ingest + 完整性检查**
 
-将所有缓存文件 ingest 到 KB，然后执行完整性检查。
+`cp` 缓存到 raw/ → `Skill("ingesting-sources")` → `Skill("updating-related-pages")` → 完整性检查。
 
 > "📋 数据完整性检查：10/10 全部通过。可以开始分析了。"
 
 **第三步：分析**
 
-从 wiki/ 页面读取结构化数据，做 SPAN 评分、利润估算、IP 检查。
+通过 `Skill("querying-the-wiki")` 查询 KB 数据，做 SPAN 评分、利润估算、IP 检查。
 
 **第四步：CDCP Gate 评审**
 

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

@@ -209,7 +209,10 @@
 
 ### Ingest
 
-按 SKILL.md「Ingest（缓存数据收录到 KB）」章节的步骤，将所有缓存文件收录到 KB。
+1. `cp ~/.scout/cache/{project}/*.json ~/kb/product-research/raw/`
+2. 执行 `Skill("ingesting-sources")` 对每个 raw/ 文件创建 source 页
+3. 执行 `Skill("updating-related-pages")` 更新 entity/overview 页
+4. `ls ~/kb/product-research/wiki/sources/` 确认来源页已生成
 
 ### 数据完整性检查
 

package/package.json

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