更新提示词和skills

.opencode/skills/runbook.md

@@ -6,6 +6,19 @@
 - `chat/stream` 内部启动 opencode 会话，并注册工具 `dynamic_http_call`。
 - opencode agent 通过工具调用后端能力，不直接发 HTTP。
 - TJWaterAgent 执行器负责“代表当前用户调真实后端 API”（动态路径，无白名单）。
+- 会话完成后，运行时会基于 transcript 做后台 learning review；这一步用于判断是否需要更新 memory 或 skill，而不是替代主任务回答。
+
+## 1.1) 自我学习闭环
+
+- **memory_manager**：保存用户长期偏好 / 约束，以及稳定 workspace 事实
+- **skill_manager**：保存经过验证、可复用的 workflow / 方法 / pitfall
+- **session_search**：检索当前用户 + 当前项目范围内的历史会话 transcript，用于回忆旧案例，避免把一次性案例写入 memory
+
+推荐分流：
+
+- 需要长期遵守的偏好 / 稳定事实 → `memory_manager`
+- 可复用的方法、步骤、坑点 → `skill_manager`
+- 某次分析过程、历史案例、临时结论 → `session_search`
 
 ## 2) 请求入口（前端）
 
@@ -54,6 +67,17 @@ SSE 事件：
 - `method` 支持：`GET/POST/PUT/PATCH/DELETE`。
 - `arguments` 会编码为 query 参数（列表会转为逗号拼接）。
 
+## 3.1) 学习工具约定
+
+- 所有学习类工具都必须带 `reason`
+- `memory_manager` 支持：`add / list / replace / remove`
+- `skill_manager` 支持：`list / append_pattern / remove_pattern / write_reference / remove_reference`
+- `session_search` 只搜索当前用户 + 当前项目作用域，不接受跨项目检索
+- `skill_manager` 的结构化写入优先落到：
+  1. `## Learned Patterns`
+  2. `references/*.md`
+  不应直接重写 skill frontmatter 或任意正文段落
+
 ## 4) 用户上下文注入（后端执行阶段）
 
 - `Authorization`（Bearer Token）
@@ -90,3 +114,10 @@ SSE 事件：
 - `dynamic_http_call`：TJWaterAgent 代理 HTTP 请求，结果返回给 opencode agent 做后续分析。
 - 前端工具：TJWaterAgent 仅推送 SSE 事件，前端直接执行，结果不返回 opencode agent。
 - `show_chart`：opencode agent 先通过 `dynamic_http_call` 查询数据，处理为 x_data + series 格式后调用 `show_chart`，前端直接渲染图表，不再请求后端。
+
+## 7) 复盘与沉淀建议
+
+- 复杂多工具任务完成后，优先判断是否产生了稳定 workflow，可写入 `skill_manager`
+- 用户明确纠正表达风格、输出格式或步骤时，优先判断是否需要写入 `memory_manager`
+- 如果你只是想确认“以前是不是处理过类似问题”，先用 `session_search`
+- 如果结果仍然只是 preview，不要基于 preview 做 learned pattern，总是先 `fetch_result_ref`