@optima-chat/optima-agent 0.9.57 → 0.9.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -100,26 +100,24 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/k
100
100
 
101
101
  ## 阶段路由
102
102
 
103
- 根据 `wiki/entities/projects/{slug}.md` 当前阶段,**必须用 Read 工具读取对应的 reference 文件并严格遵循其流程**。reference 文件路径相对于本 skill 目录,用 `Glob("**/skills/scout/references/<文件名>")` 找到绝对路径后 Read。
104
-
105
- | 阶段 | 必须 Read 的文件 |
106
- |------|-----------------|
107
- | 市场管理(MM) | `references/market-management.md` |
108
- | 概念 | `references/concept.md` |
109
- | 计划 | `references/planning.md` |
110
- | 开发 | `references/development.md` |
111
- | 验证 | `references/qualification.md` |
112
- | 发布 | `references/launch.md` |
113
- | 生命周期 | `references/lifecycle.md` |
114
- | 跨项目 | `references/cross-project.md` |
115
-
116
- **不读 reference 文件就不要执行该阶段的任何操作。**
117
-
118
- **贯穿多阶段的流程(按需 Read):**
119
- - 需求管理:`references/requirements.md`(计划→开发→验证→生命周期)
120
- - 分析方法论:`references/analysis-framework.md`
121
- - 基础指标:`references/metrics.md`
122
- - 命令详细参考:`references/commands.md`
103
+ 根据 `wiki/entities/projects/{slug}.md` 当前阶段加载对应指引:
104
+
105
+ | 阶段 | Reference |
106
+ |------|-----------|
107
+ | 市场管理(MM) | [market-management.md](references/market-management.md) |
108
+ | 概念 | [concept.md](references/concept.md) |
109
+ | 计划 | [planning.md](references/planning.md) |
110
+ | 开发 | [development.md](references/development.md) |
111
+ | 验证 | [qualification.md](references/qualification.md) |
112
+ | 发布 | [launch.md](references/launch.md) |
113
+ | 生命周期 | [lifecycle.md](references/lifecycle.md) |
114
+ | 跨项目 | [cross-project.md](references/cross-project.md) |
115
+
116
+ **贯穿多阶段的流程:**
117
+ - 需求管理:[requirements.md](references/requirements.md)(计划→开发→验证→生命周期)
118
+ - 分析方法论:[analysis-framework.md](references/analysis-framework.md)
119
+ - 基础指标:[metrics.md](references/metrics.md)
120
+ - 命令详细参考:[commands.md](references/commands.md)
123
121
 
124
122
  ## Gate 评审
125
123
 
@@ -104,14 +104,16 @@
104
104
 
105
105
  ---
106
106
 
107
- ## 第二步:Ingest + 数据完整性检查
107
+ ## === CRITICAL: 第二步 Ingest 不完成不得分析 ===
108
108
 
109
- ### Ingest
109
+ 数据采集完成后,**必须先 ingest 再分析**。跳过 ingest 直接分析是错误的——分析结果将无法追溯、无法被其他阶段复用。
110
+
111
+ ### Ingest 步骤
110
112
 
111
113
  1. `cp ~/.scout/cache/{project}/*.json ~/kb/product-research/raw/`
112
114
  2. 执行 `Skill("ingesting-sources")` 对每个 raw/ 文件创建 source 页
113
115
  3. 执行 `Skill("updating-related-pages")` 更新 entity/overview 页
114
- 4. `ls ~/kb/product-research/wiki/sources/` 确认来源页已生成
116
+ 4. **验证**:运行 `ls ~/kb/product-research/wiki/sources/` — 如果输出为空,说明 ingest 失败,必须排查原因,不得继续
115
117
 
116
118
  ### 数据完整性检查
117
119
 
@@ -154,7 +156,11 @@
154
156
 
155
157
  ## 第三步:数据分析
156
158
 
157
- **前置条件:必须先运行 `ls ~/kb/product-research/wiki/sources/` 确认来源页不为空。如果为空,说明 ingest 未完成,必须返回第二步。**
159
+ === GATE CHECK ===
160
+ 运行 `ls ~/kb/product-research/wiki/sources/ | wc -l`。
161
+ - 如果结果为 0 → **STOP。Ingest 未完成。返回第二步执行 Ingest。**
162
+ - 如果结果 > 0 → 继续分析。
163
+ === END GATE CHECK ===
158
164
 
159
165
  **所有分析数据必须通过 `Skill("querying-the-wiki")` 从 KB 查询,禁止直接读 `~/.scout/cache/` 中的 JSON 文件。**
160
166
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optima-chat/optima-agent",
3
- "version": "0.9.57",
3
+ "version": "0.9.59",
4
4
  "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",