@optima-chat/optima-agent 0.9.28 → 0.9.29

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.
@@ -9,6 +9,7 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
9
9
 
10
10
  1. 检查 `~/products/` 是否存在
11
11
  - 不存在 → 从 template/user/ 复制 PROFILE.md、OVERVIEW.md、CBB.md、ROADMAP.md 到 `~/products/`
12
+ - 初始化 git 仓库:`cd ~/products && git init && git add -A && git commit -m "init: 初始化产品研究工作区"`
12
13
  - **必须询问用户填写 PROFILE.md 的关键字段**(至少:主营市场、目标价位、最低毛利率、最低净利率、单品启动预算)。这些信息直接影响 SPAN 评分和 FAN 判断,缺失会导致分析不准确。用户可以简短回答,agent 帮填入。
13
14
  2. 检查 PROFILE.md 是否已填写关键字段
14
15
  - 未填写 → 必须询问(不能跳过关键字段:最低毛利率、最低净利率、单品启动预算)
@@ -17,7 +18,7 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
17
18
  - 指定了具体产品 → 匹配已有项目(按名称/关键词)或新建
18
19
  - 未指定 → 展示当前项目状态,询问继续/新建
19
20
  - 要求跨项目分析 → 加载 [cross-project.md](references/cross-project.md)
20
- 5. 进入项目后读取 `~/products/{slug}/RESEARCH.md`
21
+ 5. 进入项目后读取 `~/products/{slug}/RESEARCH.md` + `~/products/{slug}/LOGS.md`(了解上次做到哪了)
21
22
  6. 根据当前阶段加载对应 reference 文件
22
23
 
23
24
  ## 快速研究模式
@@ -47,7 +48,9 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
47
48
  3. 在 RESEARCH.md 中填入:产品名称、创建日期、研究目标
48
49
  4. 在 OVERVIEW.md 中添加一行到"活跃项目"表
49
50
  5. 在 ROADMAP.md 品类机会池中添加该产品(状态=已立项)
50
- 6. 检查 CBB.md:是否有可复用的能力模块?如有,告知用户并纳入 SPAN 评分考量
51
+ 6. LOGS.md 中记录:"立项:{产品名称}"
52
+ 7. 检查 CBB.md:是否有可复用的能力模块?如有,告知用户并纳入 SPAN 评分考量
53
+ 8. `cd ~/products && git add -A && git commit -m "新建项目: {slug}"`
51
54
 
52
55
  ### 切换项目
53
56
 
@@ -118,17 +121,21 @@ description: "基于 IPD 方法论的产品研究全生命周期工具。在 ~/p
118
121
 
119
122
  ### 落盘执行顺序(必须严格遵守)
120
123
 
121
- 每次执行 `scout` 命令后,**必须按以下三步操作**:
124
+ 每次执行 `scout` 命令后,**必须按以下五步操作**:
122
125
 
123
126
  1. **存原始数据** — 将命令完整输出保存到 `data/` 对应文件。使用 `--format json` 获取结构化数据。
124
127
  2. **更新 INDEX.md** — 在数据索引中添加/更新该条数据的记录(文件路径、时间、关联关系)。
125
128
  3. **更新活文档** — 基于新数据更新对应的 Markdown 活文档。
129
+ 4. **追加 LOGS.md** — 在操作日志中记录本次操作(时间 + 做了什么 + 关键发现)。
130
+ 5. **git commit** — `cd ~/products && git add -A && git commit -m "{简短描述}"`
126
131
 
127
132
  **绝对不能**:
128
133
  - 只写活文档不存原始数据(数据丢失,无法回溯和重新分析)
129
134
  - 只在对话中展示结果不落盘(下次对话无法使用)
130
135
  - 把摘要当作原始数据存储(必须是完整返回)
131
136
  - 忘记更新 INDEX.md(agent 下次无法发现已有数据)
137
+ - 忘记写 LOGS.md(跨会话上下文会丢失)
138
+ - 忘记 git commit(版本历史会断裂)
132
139
 
133
140
  **JSON 存储示例**:
134
141
  ```bash
@@ -0,0 +1,4 @@
1
+ # 操作日志
2
+
3
+ 按时间倒序记录每次操作,便于跨会话上下文恢复。新会话开始时先读此文件了解上次进展。
4
+
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@optima-chat/optima-agent",
3
- "version": "0.9.28",
3
+ "version": "0.9.29",
4
4
  "description": "基于 Claude Agent SDK 的电商运营 AI 助手",
5
5
  "type": "module",
6
6
  "main": "dist/src/index.js",