@optima-chat/optima-agent 0.9.38 → 0.9.40

package/.claude/settings.local.json

@@ -0,0 +1,166 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(gh api:*)",
+      "WebFetch(domain:platform.claude.com)",
+      "Bash(git init:*)",
+      "Bash(mkdir:*)",
+      "Bash(npm run typecheck:*)",
+      "Bash(npm view:*)",
+      "WebSearch",
+      "Bash(commerce --help)",
+      "Bash(done)",
+      "Bash(commerce product:*)",
+      "Bash(commerce order:*)",
+      "Bash(commerce i18n:*)",
+      "Bash(google-ads:*)",
+      "Bash(scout --help:*)",
+      "Bash(tree:*)",
+      "Bash(cloc:*)",
+      "Bash(npm run build:*)",
+      "Bash(git restore:*)",
+      "Bash(gh repo view:*)",
+      "Bash(mv:*)",
+      "Bash(rmdir:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push)",
+      "Bash(timeout 5 npm run optima:*)",
+      "Bash(npm install:*)",
+      "Bash(cat:*)",
+      "Bash(gh issue create:*)",
+      "Bash(npx tsx:*)",
+      "Bash(timeout 30 npx tsx:*)",
+      "Bash(git push origin feature/ask-user-question)",
+      "Bash(node:*)",
+      "Bash(npm version:*)",
+      "Bash(git push:*)",
+      "Bash(npm publish:*)",
+      "Bash(pkill:*)",
+      "Bash(git -C /Users/verypro/optima-agent log --oneline --all -- \".claude/\")",
+      "Bash(wc:*)",
+      "Bash(grep:*)",
+      "Bash(find:*)",
+      "Bash(commerce collection --help:*)",
+      "Bash(commerce collection update --help:*)",
+      "Bash(commerce collection set-cover:*)",
+      "Bash(commerce collection get --help:*)",
+      "Bash(commerce collection list --help:*)",
+      "Bash(commerce collection create --help:*)",
+      "Bash(commerce collection remove-products:*)",
+      "Bash(commerce collection list-products:*)",
+      "Bash(commerce --version:*)",
+      "Bash(bi-cli --version:*)",
+      "Bash(commerce homepage create --help:*)",
+      "Bash(commerce homepage reorder --help:*)",
+      "Bash(commerce homepage delete --help:*)",
+      "Bash(commerce homepage update-images:*)",
+      "Bash(commerce homepage update-collections:*)",
+      "Bash(commerce homepage update-target:*)",
+      "Bash(commerce homepage switch-template:*)",
+      "Bash(commerce inventory:*)",
+      "Bash(commerce merchant:*)",
+      "Bash(commerce review:*)",
+      "Bash(commerce product-page:*)",
+      "Bash(bi-cli:*)",
+      "Bash(comfy:*)",
+      "Bash(scout search:*)",
+      "Bash(scout product:*)",
+      "Bash(commerce homepage create-collections:*)",
+      "Bash(commerce homepage create-featured:*)",
+      "Bash(commerce homepage create-collection-products:*)",
+      "Bash(commerce homepage create-banner:*)",
+      "Bash(xargs -I {} sh -c 'echo \"\"\"\"=== {} ===\"\"\"\"; head -3 /Users/verypro/optima-agent/.claude/skills/{}/SKILL.md | grep \"\"\"\"name:\"\"\"\"')",
+      "Bash(ls:*)",
+      "Bash(gh issue view:*)",
+      "Bash(npx markdownlint-cli:*)",
+      "Bash(chmod:*)",
+      "Bash(npm whoami:*)",
+      "Bash(tsx test-scripts/test-headless-progress.ts:*)",
+      "Bash(DEBUG_STREAM=1 node dist/bin/optima.js:*)",
+      "Bash(git describe:*)",
+      "WebFetch(domain:github.com)",
+      "Bash(./scripts/test-headless.sh:*)",
+      "Bash(./scripts/test-headless-simple.sh:*)",
+      "Bash(env)",
+      "Bash(gh pr list:*)",
+      "Bash(gh pr view:*)",
+      "Bash(gh pr diff:*)",
+      "Bash(optima --version:*)",
+      "Bash(optima agent headless:*)",
+      "Bash(optima headless:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless.sh:*)",
+      "Bash(/Users/verypro/optima-agent/scripts/test-headless-simple.sh:*)",
+      "Bash(tee:*)",
+      "Bash(CONV_ID=\"conv-1\":*)",
+      "Bash(echo:*)",
+      "Bash(scout tiktok trending --help:*)",
+      "Bash(scout tiktok trending:*)",
+      "Bash(git checkout:*)",
+      "Bash(npm test:*)",
+      "Bash(git tag:*)",
+      "Bash(/private/tmp/claude/-Users-verypro-optima-agent/68a9ac2c-def2-44e1-b42b-e53bd9022ab6/scratchpad/test-canUseTool.sh)",
+      "Bash(optima --help:*)",
+      "Bash(npx @optima-chat/ads-cli:*)",
+      "Bash(head:*)",
+      "Bash(git pull:*)",
+      "Bash(pnpm build:*)",
+      "Skill(read-code)",
+      "Bash(npm run cli:*)",
+      "Bash(scout:*)",
+      "WebFetch(domain:docs.scrapecreators.com)",
+      "WebFetch(domain:scrapecreators.com)",
+      "Bash(gh auth status:*)",
+      "Bash(optima-agent:*)",
+      "Bash(python3:*)",
+      "Bash(python3 -c \" import sys content = sys.stdin.read\\(\\) # Find flushMessageQueueSync idx = content.find\\(''flushMessageQueueSync''\\) # Get context around it lines = content.split\\(''\\\\n''\\) for i, line in enumerate\\(lines\\): if ''flushMessageQueueSync'' in line and ''private'' in line: for j in range\\(i, min\\(i+20, len\\(lines\\)\\)\\): print\\(f''{j+1}: {lines[j]}''\\) break \")",
+      "Bash(optima:*)",
+      "WebFetch(domain:www.npmjs.com)",
+      "WebFetch(domain:registry.npmjs.org)",
+      "WebFetch(domain:zod.dev)",
+      "Bash(npm ls:*)",
+      "Bash(NODE_DEBUG=child_process npx tsx:*)",
+      "Bash(DEBUG_CLAUDE_AGENT_SDK=1 npx tsx:*)",
+      "Bash(CLAUDECODE= npx tsx:*)",
+      "Bash(env:*)",
+      "Bash(gh release:*)",
+      "Bash(npm info:*)",
+      "Bash(gh run:*)",
+      "Bash(gtimeout 90:*)",
+      "Bash(sentinel:*)",
+      "Bash(gh pr:*)",
+      "Bash(git fetch:*)",
+      "Bash(git log:*)",
+      "Bash(npm bin:*)",
+      "Bash(git status:*)",
+      "Bash(browser-cli --version && browser-cli --help)",
+      "Bash(browser-cli status:*)",
+      "Bash(browser-cli launch:*)",
+      "Bash(browser-cli screenshot:*)",
+      "Bash(browser-cli --version)",
+      "Bash(browser-cli close:*)",
+      "Bash(npm update:*)",
+      "Bash(node -e \"console.log\\(require\\('./node_modules/@optima-chat/browser-cli/package.json'\\).version\\)\")",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(aws ecs:*)",
+      "Bash(aws ecr:*)",
+      "Bash(gh search:*)",
+      "Bash(npx tsc:*)",
+      "Bash(find /Users/verypro/optima-agent -path */node_modules -prune -o -type f \\\\\\(-name *comfy* -o -name *gen* \\\\\\) -print)",
+      "Bash(export PATH=\"/usr/local/bin:$PATH\")",
+      "Bash(pnpm add:*)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/max-rounds-hit)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/budget-almost-spent)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/two-active-campaigns)",
+      "Bash(cp -r ~/optima-agent/test/skills/kol-outreach/fixtures/one-active-campaign ~/optima-agent/test/skills/kol-outreach/fixtures/brand-only)",
+      "Bash(pnpm vitest:*)",
+      "Bash(pnpm test:*)",
+      "Bash(pnpm --filter @optima-scout/backend test --reporter=verbose backend/src/routes/outreach/__tests__/lock.test.ts backend/src/routes/outreach/__tests__/inbound.test.ts)",
+      "Bash(npx vitest:*)",
+      "Bash(DATABASE_URL=postgres://optima_scout:optima_scout_dev@localhost:7293/optima_scout pnpm --filter @optima-scout/backend test)",
+      "Bash(pnpm --filter @optima-scout/backend exec vitest run src/routes/outreach/__tests__/inbound.test.ts)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

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

@@ -1,24 +1,23 @@
 ---
 name: scout
-description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/products/ 管理研究项目，跨对话持久化数据。引导用户通过概念→计划→开发→验证→发布→生命周期阶段，使用 SPAN 定位、$APPEALS 竞品评分、FAN 财务分析和结构化 Gate 评审（CDCP/PDCP/ADCP）。当用户提到以下场景时使用：产品研究、选品、市场调研、竞品分析、市场验证、需求分析、供应商、采购、1688、找货、商业分析、利润、成本、趋势、走势、热度、评论、差评、痛点、价格历史、BSR、产品组合、对比分析、卖什么、开店、做什么产品。"
+description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/kb/product-research/ 管理研究项目，跨对话持久化数据。引导用户通过概念→计划→开发→验证→发布→生命周期阶段，使用 SPAN 定位、$APPEALS 竞品评分、FAN 财务分析和结构化 Gate 评审（CDCP/PDCP/ADCP）。当用户提到以下场景时使用：产品研究、选品、市场调研、竞品分析、市场验证、需求分析、供应商、采购、1688、找货、商业分析、利润、成本、趋势、走势、热度、评论、差评、痛点、价格历史、BSR、产品组合、对比分析、卖什么、开店、做什么产品。"
 ---
 
 # Scout — IPD 产品研究
 
 ## 启动 SOP
 
-1. 检查 `~/products/` 是否存在
-   - 不存在 → 从 template/user/ 复制 PROFILE.md、OVERVIEW.md、CBB.md、ROADMAP.md 到 `~/products/`
-   - 初始化 git 仓库：`cd ~/products && git init && git add -A && git commit -m "init: 初始化产品研究工作区"`
-   - **必须询问用户填写 PROFILE.md 的关键字段**（至少：主营市场、目标价位、最低毛利率、最低净利率、单品启动预算）。这些信息直接影响 SPAN 评分和 FAN 判断，缺失会导致分析不准确。用户可以简短回答，agent 帮填入。
-2. 检查 PROFILE.md 是否已填写关键字段
+1. 检查 `~/kb/product-research/` 是否存在
+   - 不存在 → 使用 kb-skills 的 initializing-kb 流程创建（名称: product-research），AGENTS.md 内容从 `template/kb/AGENTS.md` 复制
+   - **必须询问用户填写 `wiki/entities/seller-profile.md` 的关键字段**（至少：主营市场、目标价位、最低毛利率、最低净利率、单品启动预算）。这些信息直接影响 SPAN 评分和 FAN 判断，缺失会导致分析不准确。用户可以简短回答，agent 帮填入。
+2. 检查 `wiki/entities/seller-profile.md` 是否已填写关键字段
    - 未填写 → 必须询问（不能跳过关键字段：最低毛利率、最低净利率、单品启动预算）
-3. 读取 `~/products/PROFILE.md` + `~/products/OVERVIEW.md` + `~/products/CBB.md` + `~/products/ROADMAP.md`
+3. 读取 `~/kb/product-research/wiki/entities/seller-profile.md` + `~/kb/product-research/index.md` + `~/kb/product-research/wiki/overview/roadmap.md` + `~/kb/product-research/wiki/overview/cbb.md`
 4. 判断用户意图：
-   - 指定了具体产品 → 匹配已有项目（按名称/关键词）或新建
+   - 指定了具体产品 → 匹配已有项目（检查 `wiki/entities/projects/` 下已有项目）或新建
    - 未指定 → 展示当前项目状态，询问继续/新建
    - 要求跨项目分析 → 加载 [cross-project.md](references/cross-project.md)
-5. 进入项目后读取 `~/products/{slug}/RESEARCH.md` + `~/products/{slug}/LOGS.md`（了解上次做到哪了）
+5. 进入项目后读取 `~/kb/product-research/wiki/entities/projects/{slug}.md` + `~/kb/product-research/log.md`（了解上次做到哪了）
 6. 根据当前阶段加载对应 reference 文件
 
 ## 快速研究模式
@@ -31,12 +30,13 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
 1. 立即执行 `scout search` 或 `scout product`（先拿数据再说）
 2. 分享关键发现（价格区间、竞争强度、销量信号）
 3. 询问用户："要深入研究吗？我可以立项做完整的 IPD 分析。"
-   - 用户说"深入" → 新建项目，进入概念阶段
-   - 用户说"不用" → 对话结束，数据不落盘
+   - 用户说"深入" → 使用 `scout project use <name>` 立项，会自动迁入快速模式缓存数据，进入概念阶段
+   - 用户说"不用" → 对话结束，数据已自动缓存到 `~/.scout/cache/_quick/`，如需深入可立项迁入
 
 **原则**：
 - 先数据后建议 — 不要在没有数据的情况下给任何建议
-- 快速模式不创建项目、不落盘、不走 Gate
+- 快速模式不创建项目、不走 Gate
+- CLI 自动缓存到 `~/.scout/cache/_quick/{session}/`，无需手动管理
 - 用户随时可以从快速模式升级为正式 IPD 研究
 
 ## 项目管理
@@ -44,149 +44,62 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
 ### 新建项目
 
 1. 确定 slug（英文 kebab-case，如 titanium-tumbler）
-2. 从 template/product/ 复制完整目录到 `~/products/{slug}/`
-3. 在 RESEARCH.md 中填入：产品名称、创建日期、研究目标
-4. 在 OVERVIEW.md 中添加一行到"活跃项目"表
-5. 在 ROADMAP.md 品类机会池中添加该产品（状态=已立项）
-6. 在 LOGS.md 中记录："立项：{产品名称}"
-7. 检查 CBB.md：是否有可复用的能力模块？如有，告知用户并纳入 SPAN 评分考量
-8. `cd ~/products && git add -A && git commit -m "新建项目: {slug}"`
+2. `scout project use {slug}` 设置当前项目上下文
+3. 在 `~/kb/product-research/wiki/entities/projects/{slug}.md` 中填入：产品名称、创建日期、研究目标
+4. 在 `index.md` 中添加一行到"活跃项目"表
+5. 在 `wiki/overview/roadmap.md` 品类机会池中添加该产品（状态=已立项）
+6. 在 `log.md` 中记录："立项：{产品名称}"
+7. 检查 `wiki/overview/cbb.md`：是否有可复用的能力模块？如有，告知用户并纳入 SPAN 评分考量
+8. `cd ~/kb/product-research && git add -A && git commit -m "新建项目: {slug}"`
 
 ### 切换项目
 
-读取 OVERVIEW.md → 列出活跃项目 → 用户选择 → 加载对应 RESEARCH.md
+读取 `index.md` → 列出活跃项目 → 用户选择 → 加载对应 `wiki/entities/projects/{slug}.md`
 
 ### 阶段回退
 
 如果用户要求回到前一阶段（如"我想重新评估竞品"）：
-1. 更新 RESEARCH.md 当前阶段（回退）
+1. 更新 `wiki/entities/projects/{slug}.md` 当前阶段（回退）
 2. 保留已有数据不删除
 3. 将对应阶段的 checklist 中需要重做的项取消勾选
 4. 加载对应阶段的 reference 重新执行
 
 ### 并行项目
 
-- 支持同时进行多个项目（OVERVIEW.md 多行活跃）
+- 支持同时进行多个项目（`index.md` 多行活跃）
 - 建议同时进行的概念/计划阶段项目不超过 3 个（避免资源分散）
 - 每次对话聚焦一个项目，切换时明确告知用户
 
 ### 归档项目
 
-1. 更新 RESEARCH.md 状态 → 已决策(Go) 或 已决策(No-Go)
-2. 更新 OVERVIEW.md：从"活跃项目"移到"已完结"
-3. 提示用户："这次研究积累了什么可复用的能力？"→ 更新 CBB.md
-
-## 数据落盘规则
-
-### 前提
-
-数据只在**有明确关联项目**时自动落盘：
-- 已选定项目 → 自动落盘到对应目录
-- 未选定项目 → 提示："这个搜索结果要保存到某个项目里吗？"
-  - 指定项目 → 落盘
-  - 新建项目 → 初始化后落盘
-  - 不保存 → 仅存在于对话上下文
-
-### 落盘映射
-
-原始数据统一存放在 `data/` 目录，活文档在各子目录。
-
-| 命令 | 原始数据（data/ 下） | 更新的活文档 | 更新 INDEX.md |
-|------|-------------------|------------|-------------|
-| `scout search` | data/searches/{date}-{keyword}.json | market/MARKET.md | ✅ |
-| `scout tiktok *` | data/social/{date}-tiktok.json | market/MARKET.md | ✅ |
-| `scout reddit *` | data/social/{date}-reddit.json | market/MARKET.md | ✅ |
-| `scout twitter *` | data/social/{date}-twitter.json | market/MARKET.md | ✅ |
-| `scout instagram *` | data/social/{date}-instagram.json | market/MARKET.md | ✅ |
-| `scout douyin *` | data/social/{date}-douyin.json | market/MARKET.md | ✅ |
-| `scout xhs *` | data/social/{date}-xhs.json | market/MARKET.md | ✅ |
-| `scout shein-search` | data/searches/{date}-shein.json | market/MARKET.md | ✅ |
-| `scout temu-search` | data/searches/{date}-temu.json | market/MARKET.md | ✅ |
-| `scout taobao *` | data/searches/{date}-taobao.json | market/MARKET.md | ✅ |
-| Web Search | data/social/{date}-web.json | market/MARKET.md | ✅ |
-| `scout product` | data/products/{ASIN}.json | competitors/COMPETITORS.md | ✅ |
-| `scout reviews` | data/reviews/{ASIN}-{star}.json | reviews/PAIN-POINTS.md | ✅ |
-| `scout keepa product` | data/keepa/{date}-batch.json | trends/TRENDS.md | ✅ |
-| `scout supplier-search` | data/suppliers/{date}-keyword.json | suppliers/SUPPLIERS.md | ✅ |
-| `scout supplier-search-image` | data/suppliers/{date}-image.json | suppliers/SUPPLIERS.md | ✅ |
-| `scout sp keywords` | data/sellersprite/{ASIN}-keywords.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp keywords-mine` | data/sellersprite/{date}-{keyword}-mine.json | market/MARKET.md | ✅ |
-| `scout sp keywords-order` | data/sellersprite/{ASIN}-orders.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp keywords-research` | data/sellersprite/{date}-{keyword}-research.json | market/MARKET.md | ✅ |
-| `scout sp keywords-trends` | data/sellersprite/{date}-{keyword}-trends.json | trends/TRENDS.md | ✅ |
-| `scout sp traffic-*` | data/sellersprite/{ASIN}-traffic-{type}.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp predict` | data/sellersprite/{ASIN}-predict.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp competitors` | data/sellersprite/{ASIN}-competitors.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp coupon` | data/sellersprite/{ASIN}-coupon.json | competitors/COMPETITORS.md | ✅ |
-| `scout sp category` | data/sellersprite/{date}-category-{keyword}.json | market/MARKET.md | ✅ |
-| `scout sp market*` | data/sellersprite/{date}-market-{nodeIdPath}.json | market/MARKET.md | ✅ |
-| `scout sp brands` | data/sellersprite/{date}-brands-{nodeIdPath}.json | market/MARKET.md | ✅ |
-| `scout sp sellers` | data/sellersprite/{date}-sellers-{nodeIdPath}.json | market/MARKET.md | ✅ |
-| `scout sp demand` | data/sellersprite/{date}-demand-{nodeIdPath}.json | market/MARKET.md | ✅ |
-| `scout sp prices` | data/sellersprite/{date}-prices-{nodeIdPath}.json | market/MARKET.md | ✅ |
-| `scout sp google-trend` | data/sellersprite/{date}-google-{keyword}.json | market/MARKET.md | ✅ |
-| `scout sp aba-*` | data/sellersprite/{date}-aba-{keyword}.json | market/MARKET.md | ✅ |
-
-**文件命名规则**：
-- `{date}` = YYYY-MM-DD（如 2026-05-05）
-- `{keyword}` = 搜索关键词的 slug（如 open-ear-earbuds）
-- `{ASIN}` = 10 位 Amazon 产品 ID
-- `{star}` = 评论星级筛选（如 one-star、all-stars）
-- 同一 ASIN 多次拉取时覆盖（产品数据取最新值）；搜索类数据带日期不覆盖
-
-**注意**：所有路径相对于项目目录 `~/products/{slug}/`。
-
-### 落盘执行顺序（必须严格遵守）
-
-每次执行 `scout` 命令后，**必须按以下五步操作**：
-
-1. **存原始数据** — 将命令完整输出保存到 `data/` 对应文件。使用 `--format json` 获取结构化数据。
-2. **更新 INDEX.md** — 在数据索引中添加/更新该条数据的记录（文件路径、时间、关联关系）。
-3. **更新活文档** — 基于新数据更新对应的 Markdown 活文档。
-4. **追加 LOGS.md** — 在操作日志中记录本次操作（时间 + 做了什么 + 关键发现）。
-5. **git commit** — `cd ~/products && git add -A && git commit -m "{简短描述}"`
-
-**绝对不能**：
-- 只写活文档不存原始数据（数据丢失，无法回溯和重新分析）
-- 只在对话中展示结果不落盘（下次对话无法使用）
-- 把摘要当作原始数据存储（必须是完整返回）
-- 忘记更新 INDEX.md（agent 下次无法发现已有数据）
-- 忘记写 LOGS.md（跨会话上下文会丢失）
-- 忘记 git commit（版本历史会断裂）
-
-**JSON 存储示例**：
-```bash
-# 正确做法：命令输出直接存文件
-scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.json
-# 然后将结果追加到项目 JSON 文件
-```
+1. 更新 `wiki/entities/projects/{slug}.md` 状态 → 已决策(Go) 或 已决策(No-Go)
+2. 更新 `index.md`：从"活跃项目"移到"已完结"
+3. 提示用户："这次研究积累了什么可复用的能力？"→ 更新 `wiki/overview/cbb.md`
 
-### JSON 格式
+## 数据管理
 
-每个 JSON 文件是数组，每次追加带时间戳的条目：
-```json
-[
-  { "timestamp": "2026-05-05T10:30:00Z", "command": "scout search", "args": {"query": "titanium cup", "limit": 15}, "results": [...] }
-]
-```
+### CLI 自动缓存
+
+所有 `scout` 数据命令执行后自动缓存完整 JSON 到 `~/.scout/cache/{project}/`。
+- 使用 `scout project use <name>` 设置当前项目
+- 使用 `scout cache list` 查看已缓存文件
+- stdout 输出摘要 + 缓存路径，不再输出完整 JSON
 
-### 活文档更新策略
+### 数据进入 KB
 
-活文档不是追加原始数据，而是**分析性更新**：
-- 新数据进来后重新审视文档，更新总结和判断
-- 新数据与旧分析矛盾时，更新结论并标注变化原因
-- 保持简洁可读（原始数据的职责在 JSON 中）
+数据通过 kb-skills 的 ingest 流程进入 `~/kb/product-research/`：
+- 在数据完整性检查通过后批量 ingest
+- ingest 将缓存文件复制到 `raw/`，生成 `wiki/sources/` 摘要页
+- 自动更新相关 entity 和 overview 页面
+- 具体 ingest 规则见 `~/kb/product-research/AGENTS.md`
 
-### Checklist 自动更新
+### 分析数据来源
 
-每次落盘后判断对应 checklist 项是否满足完成标准：
-- 不是"跑过命令=完成"，而是**数据充分性**判断
-- 未完成时主动建议补充数据
-- 全部完成时主动发起 Gate 评审
+agent 分析时读 `wiki/` 下的结构化页面，不直接读 raw JSON。
 
 ## 阶段路由
 
-根据 RESEARCH.md "当前阶段"加载对应指引：
+根据 `wiki/entities/projects/{slug}.md` 当前阶段加载对应指引：
 
 | 阶段 | Reference |
 |------|-----------|
@@ -214,7 +127,7 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 2. 逐项回答评审问题，引用已收集数据作为证据
 3. 给出 Go/Kill/Redirect 建议
 4. 等待用户确认
-5. 确认后更新 RESEARCH.md（阶段、决策记录）+ OVERVIEW.md
+5. 确认后更新 `wiki/entities/projects/{slug}.md`（阶段、决策记录）+ `index.md`
 
 **评审结果格式：**
 ```
@@ -229,7 +142,7 @@ scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.jso
 
 ## 报告生成
 
-用户可随时要求生成报告，保存到 `~/products/{slug}/reports/YYYY-MM-DD-{标题}.md`。
+用户可随时要求生成报告，保存到 `~/kb/product-research/wiki/analyses/{slug}-{type}.md`。
 
 报告类型对齐 IPD 交付物：
 - 市场管理(MM) → 品类分析报告
@@ -297,17 +210,9 @@ Shein/Temu 低价（$X）vs Amazon 中高价（$Y）vs 1688 成本（¥Z）
 
 **不要用 WebFetch 直接抓 Amazon 页面**（会被反爬拦截）。
 
-## KB 集成（可选）
-
-如果 `~/kb/` 存在且有相关知识库：
-- 分析阶段可查询已有实体页、综述页辅助判断
-- 避免重复研究已知信息
-
-报告生成后可建议用户 ingest 到 KB：
-- "这份报告要收录到知识库吗？"
-- 用户同意 → 触发 ingesting-sources 流程
+## KB 集成
 
-**不自动创建 KB。** 当积累 3+ 个完成的研究项目后，可主动建议创建产品研究知识库。
+`~/kb/product-research/` 是产品研究的主数据存储。所有研究数据通过 CLI 自动缓存后，经 kb-skills 的 ingest 流程进入 KB。分析时读取 `wiki/` 下的结构化页面，不直接读 raw JSON。
 
 ## 交互风格
 
@@ -315,5 +220,5 @@ Shein/Temu 低价（$X）vs Amazon 中高价（$Y）vs 1688 成本（¥Z）
 - 每次操作后分享关键发现，不堆砌原始数据
 - 根据阶段主动建议下一步动作
 - Gate 评审时给出明确建议但尊重用户决策
-- 参考 PROFILE.md 过滤不匹配的产品/方向
+- 参考 `wiki/entities/seller-profile.md` 过滤不匹配的产品/方向
 - 数据不足时主动建议补充，不强行给结论

package/.claude/skills/scout/references/analysis-framework.md

@@ -25,7 +25,7 @@ SPAN 是一个 2×2 矩阵工具，用于判断一个商机是否值得投入。
 | 维度 | 权重 | 数据来源 | 评分标准 |
 |------|------|----------|----------|
 | 差异化能力 | 35% | $APPEALS 竞品缺口分析 | 5=明确可实现的差异化, 4=较明确, 3=有空间但不确定, 2=空间小, 1=无差异化空间 |
-| 资金匹配度 | 25% | PROFILE 预算 vs 所需投入 | 5=充裕(>3倍), 4=宽裕(2-3倍), 3=匹配, 2=紧张, 1=不足 |
+| 资金匹配度 | 25% | seller-profile 预算 vs 所需投入 | 5=充裕(>3倍), 4=宽裕(2-3倍), 3=匹配, 2=紧张, 1=不足 |
 | 供应链能力 | 25% | 1688 供应商搜索结果 | 5=多家优质+低MOQ, 4=多家可选, 3=少量可用, 2=选择有限, 1=极少或无 |
 | 进入壁垒 | 15% | 头部评论数/品牌占比/认证要求；可用 `scout sp brands` 量化品牌集中度 | 5=低壁垒(无品牌垄断), 4=较低, 3=中等, 2=较高, 1=极高(强品牌+认证+专利) |
 
@@ -116,7 +116,7 @@ SPAN 是一个 2×2 矩阵工具，用于判断一个商机是否值得投入。
 
 ### 判断标准
 
-- 对照 PROFILE.md 中定义的**最低净利率**要求
+- 对照 wiki/entities/seller-profile.md 中定义的**最低净利率**要求
 - 基准场景净利率 ≥ 最低要求 → 通过
 - 悲观场景仍盈利 → 安全
 - 基准场景不达标 → 不通过，除非有明确的战略理由
@@ -133,7 +133,7 @@ IPD 流程中的三个关键决策门（Decision Checkpoint），每个Gate有5
 | # | 问题 | 通过标准 | Kill 标准 |
 |---|------|----------|-----------|
 | 1 | 市场是否真实存在？ | 月搜索量>1000 或 BSR drops 验证需求 | 搜索量<100 且无增长趋势 |
-| 2 | 能赚钱吗？ | 初步估算毛利率 ≥ PROFILE 最低毛利率 | 毛利率 < 20% |
+| 2 | 能赚钱吗？ | 初步估算毛利率 ≥ seller-profile 最低毛利率 | 毛利率 < 20% |
 | 3 | 竞争打得过吗？ | 存在可实现的差异化方向 | 头部5家全是强品牌+高评论 |
 | 4 | 有法律/合规风险吗？ | 无专利/认证/资质壁垒 或 可解决 | 存在不可规避的专利/强制认证 |
 | 5 | SPAN 定位可接受吗？ | 落入投资或选择性投入象限 | 落入退出象限 |
@@ -146,7 +146,7 @@ IPD 流程中的三个关键决策门（Decision Checkpoint），每个Gate有5
 |---|------|----------|-----------|
 | 1 | 差异化是否明确？ | $APPEALS 识别出2+高权重弱项维度 | 无法找到差异化切入点 |
 | 2 | 供应商是否可行？ | 已联系2+供应商, MOQ/价格可接受 | 无法找到合格供应商 |
-| 3 | 财务模型是否成立？ | FAN 基准场景净利率 ≥ PROFILE 最低净利率 | 悲观场景亏损且无改善路径 |
+| 3 | 财务模型是否成立？ | FAN 基准场景净利率 ≥ seller-profile 最低净利率 | 悲观场景亏损且无改善路径 |
 | 4 | 风险是否可控？ | 已识别TOP 3风险并有对策 | 存在不可控致命风险 |
 | 5 | 时间窗口是否合适？ | 能在旺季前3个月就位 | 已错过时间窗口且无下一窗口 |