@optima-chat/optima-agent 0.9.26 → 0.9.27
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.
|
@@ -107,6 +107,25 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
|
|
|
107
107
|
|
|
108
108
|
**注意**：所有路径相对于项目目录 `~/products/{slug}/`。不要在其他目录创建文件。
|
|
109
109
|
|
|
110
|
+
### 落盘执行顺序（必须严格遵守）
|
|
111
|
+
|
|
112
|
+
每次执行 `scout` 命令后，**必须按以下顺序操作**：
|
|
113
|
+
|
|
114
|
+
1. **先存 JSON** — 将命令的完整原始输出保存到对应 JSON 文件。使用 `--format json` 获取结构化数据，重定向或写入到文件。如果文件已存在，追加到数组中（带时间戳）。
|
|
115
|
+
2. **再写活文档** — 基于数据分析后更新对应的 Markdown 活文档。
|
|
116
|
+
|
|
117
|
+
**绝对不能**：
|
|
118
|
+
- 只写活文档不存 JSON（原始数据会丢失，无法回溯）
|
|
119
|
+
- 只在对话中展示结果不落盘（数据不会持久化）
|
|
120
|
+
- 把命令输出摘要当作 JSON 存储（必须是完整的原始返回）
|
|
121
|
+
|
|
122
|
+
**JSON 存储示例**：
|
|
123
|
+
```bash
|
|
124
|
+
# 正确做法：命令输出直接存文件
|
|
125
|
+
scout search "open ear earbuds" --limit 15 --format json > /tmp/scout-result.json
|
|
126
|
+
# 然后将结果追加到项目 JSON 文件
|
|
127
|
+
```
|
|
128
|
+
|
|
110
129
|
### JSON 格式
|
|
111
130
|
|
|
112
131
|
每个 JSON 文件是数组，每次追加带时间戳的条目：
|