@vima_tech/telos 1.4.0 → 1.4.1

package/skills/_kernel/codewords.md

@@ -0,0 +1,264 @@
+---
+name: codewords
+version: 1.0
+description: >
+  暗号系统协议。用户通过自然语言"暗号"触发 Telos 各项功能，
+  无需记忆斜杠命令。支持默认暗号 + 自定义暗号，可随时增删改。
+---
+
+# 暗号系统（Codewords）
+
+**核心思想：用日常用语代替命令。**
+
+不用记 `/skill save`，说"记下来"就行。
+不用记 `/skill list`，说"看看家底"就行。
+
+暗号是用户和 Telos 之间的"约定暗语"——说出任意一个别名，对应的功能立即触发。
+
+---
+
+## 暗号配置文件
+
+暗号存储在 `.telos-config.json` 的 `codewords` 字段中：
+
+```json
+{
+  "codewords": {
+    "enabled": true,
+    "hint_on_start": true,
+    "save": {
+      "description": "保存当前对话中的技能知识",
+      "action": "skill_save",
+      "aliases": ["记下来", "保存", "存一下"]
+    },
+    "list": {
+      "description": "查看已掌握的所有技能",
+      "action": "skill_list",
+      "aliases": ["我都有什么技能", "看看家底"]
+    }
+  }
+}
+```
+
+---
+
+## 默认暗号表
+
+| 暗号ID | 动作 | 默认别名 | 说明 |
+|---|---|---|---|
+| `save` | 保存技能 | 记下来、保存、存一下、存起来、归档、收入囊中 | 提取当前对话的程序性知识 |
+| `list` | 列出技能 | 我都有什么技能、看看家底、技能库、有哪些技能、翻翻看 | 查看技能库全貌 |
+| `load` | 加载技能 | 加载技能、唤起、拿出来 | 手动加载某领域到当前对话 |
+| `delete` | 删除技能 | 删掉、移除、清空这个 | 删除指定技能（需确认） |
+| `distill` | 触发蒸馏 | 蒸馏、进化、复盘、总结提升 | 从反馈中进化协议 Skill |
+| `telos` | 启动飞轮 | 启动飞轮、开始分析、专家会诊 | 激活 Telos 分析模式 |
+| `show_codewords` | 显示暗号 | 暗号大全、有哪些暗号、对暗号、help | 列出所有可用暗号 |
+
+---
+
+## 暗号触发协议
+
+### 触发时机
+
+每次用户发送消息后，**在生成回复前**执行暗号检测：
+
+1. 读取 `.telos-config.json` → `codewords`
+2. 若 `enabled: false`，跳过暗号检测
+3. 遍历所有暗号的 `aliases`
+4. 若用户消息中包含任一 alias（模糊匹配，允许前后有汉字/标点）：
+   - 提取匹配到的暗号
+   - 执行对应 `action`
+   - **暗号优先于普通回复**：如果消息纯为暗号，只执行动作；如果暗号嵌入在对话中，执行动作后继续正常对话
+
+### 模糊匹配规则
+
+```
+用户消息："这个方法挺好的，记下来吧"
+→ 匹配到 alias "记下来"
+→ 触发 save 动作
+
+用户消息："帮我看看家底"
+→ 匹配到 alias "看看家底"
+→ 触发 list 动作
+
+用户消息："暗号大全"
+→ 匹配到 alias "暗号大全"
+→ 触发 show_codewords 动作
+```
+
+**不匹配的情况：**
+```
+用户消息："我想记录一下这个想法"（不包含精确 alias）
+→ 不触发（除非用户把"记录一下"加入 aliases）
+```
+
+### 动作执行表
+
+| action | 执行行为 |
+|---|---|
+| `skill_save` | 读取 `skill-extraction.md`，执行无感模式保存流程 |
+| `skill_list` | 扫描 `skills/` 目录，分类展示所有技能 |
+| `skill_load` | 询问用户加载哪个领域，然后读取对应技能文件 |
+| `skill_delete` | 询问用户删除哪个技能，确认后删除 |
+| `distill` | 读取 `distillation.md`，执行蒸馏流程 |
+| `telos_start` | 执行 `.claude/commands/telos.md` 的启动流程 |
+| `show_codewords` | 展示当前所有暗号及其别名 |
+
+---
+
+## 暗号提示协议
+
+### 启动时提示
+
+若 `codewords.hint_on_start: true`，首次进入 Telos 会话时：
+
+```
+━━━ Telos 已就绪 ━━━
+
+你可以像日常聊天一样使用我。
+几个常用暗号：
+  • 说"记下来" — 保存刚才聊的技巧
+  • 说"看看家底" — 查看你的技能库
+  • 说"暗号大全" — 查看所有可用暗号
+
+随时说"对暗号"查看完整列表。
+━━━━━━━━━━━━━━━━━━━━
+```
+
+### 软提示中引用暗号
+
+无感模式的软提示（检测到程序性知识时的提示）改为引用暗号：
+
+```
+刚才聊的 [领域] 技巧挺实用的，要我帮你存起来吗？
+（说"记下来"即可保存，说"不用了"跳过）
+```
+
+### 保存完成后提示相关暗号
+
+```
+✓ 已保存到 skills/cooking/braising.md
+
+相关暗号：
+  • 说"看看家底"查看所有技能
+  • 说"翻翻看"浏览技能库
+━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 暗号管理
+
+### 查看所有暗号
+
+```
+用户：暗号大全
+
+系统：
+━━━ 暗号大全 ━━━
+
+💾 保存类
+  记下来 / 保存 / 存一下 / 存起来 / 归档 / 收入囊中
+  → 保存当前对话中的技能知识
+
+📚 查询类
+  我都有什么技能 / 看看家底 / 技能库 / 有哪些技能 / 翻翻看
+  → 查看已掌握的所有技能
+
+🚀 启动类
+  启动飞轮 / 开始分析 / 专家会诊
+  → 激活 Telos 分析模式
+
+...
+
+💡 管理暗号：说"新增暗号"、"改暗号"、"删暗号"
+━━━━━━━━━━━━━━━━━━━━
+```
+
+### 新增暗号
+
+```
+用户：新增暗号
+
+系统：
+━━━ 新增暗号 ━━━
+请告诉我：
+1. 暗号名称（英文ID，如 my-save）：
+2. 触发词（说哪些词时触发，可多组，用逗号分隔）：
+3. 对应动作（skill_save / skill_list / distill / telos_start）：
+4. 描述（一句话说明）：
+
+━━━━━━━━━━━━━━━━━━━━
+```
+
+收到信息后，更新 `.telos-config.json`：
+
+```json
+"my_save": {
+  "description": "我的保存暗号",
+  "action": "skill_save",
+  "aliases": ["收入囊中", "收好", "mark"]
+}
+```
+
+### 修改暗号
+
+```
+用户：改暗号
+或：修改暗号 save
+
+系统：
+━━━ 修改暗号 ━━━
+当前暗号：save（保存技能）
+当前别名：记下来、保存、存一下、存起来、归档、收入囊中
+
+要修改哪一项？
+1. 添加别名
+2. 删除别名
+3. 修改描述
+4. 修改动作
+
+━━━━━━━━━━━━━━━━━━━━
+```
+
+### 删除暗号
+
+```
+用户：删暗号 save
+
+系统：
+确认删除暗号 "save"？其别名将失效：记下来、保存、存一下...
+(y/n)
+```
+
+**注意：** 默认暗号（save、list、load、delete、distill、telos、show_codewords）可以删除别名，但不建议完全删除暗号本身。如果用户坚持删除，允许删除但给出警告。
+
+---
+
+## 命令模式等价操作
+
+| 自然语言 | 命令模式 |
+|---|---|
+| 暗号大全 / 对暗号 / 有哪些暗号 | `/codeword list` |
+| 新增暗号 | `/codeword add` |
+| 改暗号 | `/codeword edit <id>` |
+| 删暗号 | `/codeword remove <id>` |
+
+---
+
+## 暗号设计建议
+
+**给用户的设计原则：**
+1. **个性化**：用自己顺口的词，比如"收好"、"码住"、"存锦囊"
+2. **简短**：1-3个字最佳，说出来不费力
+3. **不冲突**：避免日常高频词（如"好的"、"知道了"）
+4. **成体系**：可以按领域设计暗号，比如烹饪领域用"收菜谱"，编程领域用"记套路"
+
+**推荐个性化暗号示例：**
+```json
+"my_cooking": {
+  "description": "保存烹饪技巧",
+  "action": "skill_save",
+  "aliases": ["收菜谱", "记下这个菜", "菜谱+1"]
+}
+```

package/skills/_kernel/skill-extraction.md

@@ -1,9 +1,10 @@
 ---
 name: skill-extraction
-version: 1.0
+version: 2.0
 description: >
   用户技能提炼协议。从任意对话（烹饪、写作、谈判、编程……）中
   提炼程序性知识，写入 skills/ 技能库，下次同类对话自动加载。
+  支持完全无感模式：用户无需记命令，像日常聊天一样即可积累技能。
 ---
 
 # 技能提炼协议（Skill Extraction）
@@ -13,6 +14,19 @@ description: >
 
 ---
 
+## 核心设计：双模式支持
+
+| 模式 | 说明 | 适用场景 |
+|---|---|---|
+| **无感模式（默认）** | 对话中自动检测知识，自然语言触发，无需记命令 | 日常聊天、随手记录 |
+| **命令模式** | 使用 `/skill save` 等精确命令 | 批量整理、明确意图 |
+
+**原则：无感模式优先。** 用户像和豆包聊天一样对话，系统在合适时机自动提议保存。
+
+**暗号系统：** 所有自然语言触发词统称为"暗号"，用户可自定义。说出暗号即可触发对应功能，无需记忆斜杠命令。详见 `skills/_kernel/codewords.md`。
+
+---
+
 ## 什么值得提炼
 
 **值得提炼（程序性知识）：**
@@ -20,50 +34,182 @@ description: >
 - 用户学到了一个技巧：「原来关键在于……」
 - 对话中出现了可复用的步骤序列
 - 用户自己总结了规律：「这类情况要注意……」
+- 用户说"这个方法挺好"、"这个思路不错"、"学到了"
 
 **不值得提炼：**
 - 纯事实查询（「今天天气怎么样」）
 - 一次性任务（「帮我给 John 写封邮件」）
 - 无法泛化的特例（「这次项目的具体参数是……」）
+- 闲聊、情绪表达（无知识增量）
 
 ---
 
-## 触发方式
+## 无感模式协议
 
-| 触发 | 说明 |
-|---|---|
-| `/skill save [主题]` | 用户主动保存当前对话的技巧 |
-| `保存这个技巧` / `记住这个方法` | 中文主动触发 |
-| 对话结束时检测到程序性知识 | Claude 主动提议（见"软提示"协议） |
-| `/skill save` （无参数） | Claude 自动推断主题 |
+### 触发时机（满足任一即触发）
 
----
+```
+□ 用户说出 save 类暗号（"记下来"、"保存"、"存一下"等）
+□ 用户说出 show_codewords 暗号（"暗号大全"、"对暗号"等）
+□ 用户说"这个方法挺好"、"学到了"、"记住了"、"明白了"
+□ 对话超过 6 轮，且包含步骤序列或技巧总结
+□ 用户分享了自己的经验/习惯/工作流程
+□ 对话末尾，用户未明确拒绝保存，且检测到程序性知识
+```
+
+### 暗号触发词表
+
+暗号从 `.telos-config.json` → `codewords` 读取。默认暗号如下：
+
+**save（保存技能）：**
+> "记下来"、"保存"、"存一下"、"存起来"、"归档"、"收入囊中"
+
+**list（查看技能库）：**
+> "我都有什么技能"、"看看家底"、"技能库"、"有哪些技能"、"翻翻看"
+
+**show_codewords（查看所有暗号）：**
+> "暗号大全"、"有哪些暗号"、"对暗号"、"help"
+
+**完整暗号表：** 说"暗号大全"查看，或查阅 `skills/_kernel/codewords.md`。
+
+**暗示保存类（非暗号，由系统检测）：**
+> "这个方法挺好"、"学到了"、"记住了"、"明白了"、"这个思路不错"、
+> "原来如此"、"受教了"、"mark 一下"、"码住"
+
+**询问类：**
+> "要保存吗"、"这个需要记吗"、"值得记录吗"
 
-## 软提示协议（被动检测）
+### 暗号检测优先级
 
-在每轮对话后，检测以下信号（满足任意 2 个即触发软提示）：
+1. **硬暗号（精确匹配 aliases）**：用户消息中包含任一暗号别名 → 立即执行对应动作
+2. **软提示（暗示类信号）**：未触发硬暗号，但检测到程序性知识暗示 → 在回复末尾自然提议
+3. **正常对话**：未触发以上任一 → 正常回复
+
+### 无感模式执行流程
+
+**Step N1：意图识别（自动）**
+
+从用户消息中识别保存意图，无需询问确认：
 
 ```
-□ 对话超过 6 轮
-□ 出现步骤序列（「首先…然后…最后」/ 「先…再…」）
-□ 用户说过「明白了」「原来如此」「记住了」「这个技巧」「这个方法」
-□ 技术术语密度高（某一领域词汇出现 ≥ 3 次）
-□ 用户分享了自己的经验/习惯
+用户说："今天聊的红烧肉技巧记下来"
+→ 匹配到暗号 save
+→ 意图：保存 cooking/braising
+→ 进入 Step N2
+
+用户说："暗号大全"
+→ 匹配到暗号 show_codewords
+→ 意图：展示所有暗号
+→ 直接输出暗号表，跳过剩余步骤
+
+用户说："这个方法挺好的"
+→ 未匹配到硬暗号
+→ 意图：暗示保存，软提示（见下文）
+→ 进入 Step N3（软提示）
 ```
 
-触发后，在回复末尾追加（仅追加一次，不重复提示）：
+**Step N2：静默推断（不打扰用户）**
+
+自动推断以下信息，**不需要逐个询问用户**：
 
 ```
----
-💡 本次对话包含可复用的 [检测到的领域] 技巧。
-   输入 `/skill save` 或「保存这个技巧」可存入你的技能库，下次同类对话自动调用。
+领域（domain）：   从对话主题自动推断（cooking / writing / coding / ...）
+子领域（sub）：    从具体内容自动推断
+技能名（name）：   自动生成简短英文标识
+目标文件：        skills/{domain}/{name}.md
+```
+
+若 `skills/{domain}/{name}.md` 已存在 → **更新模式**（合并而非覆盖）。
+若不存在 → **新建模式**。
+
+**只在无法自动推断时询问用户：**
+```
+💡 想保存到哪个领域？比如 cooking、writing、coding...
+```
+
+**Step N3：软提示（被动检测，非强制）**
+
+当检测到暗示保存类信号时，在回复末尾自然追加（每会话最多一次）：
+
+```
+刚才聊的 [检测到的领域] 技巧挺实用的，要我帮你存起来吗？
+说"记下来"即可保存，说"不用了"跳过。
+```
+
+用户回复 "好"、"存"、"要"、"行"、"记下来" → 立即执行保存。
+用户回复 "不用"、"不用了"、"否"、"先不用" → 跳过，本会话不再提示。
+用户不回复（继续其他话题）→ 不保存，不打扰。
+
+**Step N4：内容提炼与预览（自动）**
+
+自动从对话中提炼程序性知识，直接生成预览：
+
+```
+━━━ 技能提炼预览 ━━━
+领域：{domain} / {sub-domain}
+文件：skills/{domain}/{name}.md（{新建 | 更新}）
+
+已整理出以下内容：
+  • {技巧1}
+  • {技巧2}
+  • {技巧3}
+
+确认写入？(y / n / 再改改)
+━━━━━━━━━━━━━━━━━━
+```
+
+**无感模式下预览可配置为自动确认：**
+- 如果用户设置了 `auto_confirm_skill_save: true`（可在 CLAUDE.md 中配置），
+  直接写入，不展示预览。
+- 默认展示预览，但保持简洁，不超过 10 行。
+
+**Step N5：执行写入**
+
+用户确认后（或自动确认），执行写入并输出：
+
+```
+✓ 已保存到 skills/{domain}/{name}.md
+  共 {N} 条技巧，下次 {domain} 话题自动加载。
 ```
 
 ---
 
-## E-Step 1：意图解析
+## 命令模式协议（保留，作为备选）
+
+### 触发命令
 
-确认以下信息（可询问用户，或自动推断）：
+| 命令 | 说明 |
+|---|---|
+| `/skill save [主题]` | 用户主动保存当前对话的技巧 |
+| `/skill save` （无参数） | 自动推断主题 |
+| `保存这个技巧` / `记住这个方法` | 中文命令触发 |
+| `/skills` 或 `/skill list` | 查看所有技能 |
+| `/skill show [name]` | 查看指定技能 |
+| `/skill delete [domain/name]` | 删除技能 |
+| `/codeword list` | 查看所有暗号 |
+| `/codeword add` | 新增暗号 |
+| `/codeword edit <id>` | 修改暗号 |
+| `/codeword remove <id>` | 删除暗号 |
+
+### 命令模式执行流程
+
+命令模式下执行 **E-Step 1～5** 的完整流程（见下文）。
+命令模式适合批量整理、明确意图的场景。
+
+### 暗号管理（自然语言）
+
+| 用户自然语言 | 系统行为 |
+|---|---|
+| "暗号大全" / "对暗号" / "有哪些暗号" | 列出所有暗号 |
+| "新增暗号" / "加个暗号" | 进入新增暗号流程 |
+| "改暗号" / "修改暗号" | 进入修改暗号流程 |
+| "删暗号" / "去掉暗号" | 进入删除暗号流程 |
+
+---
+
+## E-Step 1：意图解析（命令模式）
+
+确认以下信息（可自动推断，或询问用户）：
 
 ```
 领域（domain）：   cooking / writing / negotiation / coding / [其他]
@@ -72,8 +218,8 @@ description: >
 目标文件：        skills/{domain}/{name}.md
 ```
 
-若 `skills/{domain}/{name}.md` 已存在 → 进入**更新模式**（合并而非覆盖）。
-若不存在 → 进入**新建模式**。
+若 `skills/{domain}/{name}.md` 已存在 → **更新模式**（合并而非覆盖）。
+若不存在 → **新建模式**。
 
 ---
 
@@ -95,7 +241,7 @@ description: >
 
 ---
 
-## E-Step 3：生成预览
+## E-Step 3：生成预览（命令模式）
 
 ```
 ━━━ 技能提炼预览 ━━━
@@ -183,7 +329,7 @@ conversation_count: 1
 
 ## 技能加载协议（Skill Loading）
 
-**触发时机：** 对话开始，用户第一条消息发出后。
+**触发时机：** 对话开始，用户第一条消息发出后（静默执行，不向用户展示加载过程）。
 
 **执行步骤：**
 
@@ -201,7 +347,28 @@ conversation_count: 1
 改说：「基于你已有的焦糖化基础，炖牛腩的关键差异在于…」（递进讲）
 ```
 
-**无匹配时：** 正常对话，结束时若检测到程序性知识则触发软提示。
+**无匹配时：** 正常对话，结束时若检测到程序性知识则触发软提示（无感模式）或等待用户命令。
+
+---
+
+## 技能迭代优化协议
+
+当用户继续同一话题的对话时，系统自动检测新增知识并提议更新已有技能：
+
+```
+检测到你在 {domain} 话题上又积累了一些新技巧。
+要更新 skills/{domain}/{name}.md 吗？
+```
+
+用户确认后：
+1. 读取已有技能文件
+2. 合并新提炼的知识（去重、标注更新）
+3. `conversation_count` +1，`last_updated` 更新
+4. 输出更新摘要
+
+**自动优化（可选配置）：**
+如果用户开启 `auto_evolve_skills: true`，当同一技能的 `conversation_count` 达到 3 时，
+系统自动整理和优化该技能文件的表达（不改变内容，只优化结构和清晰度）。
 
 ---
 

package/skills/_template/skill.yaml

@@ -9,6 +9,8 @@ tier: workspace
 ring1_protocol: skills/your-skill-name/domain.md
 ring1_artifacts_doc: execution-doc.md
 ring2_bridge: scripts/bridge-to-coder.sh
+# Ring 2 默认工具：claude / opencode / codex / trae / cursor
+# 用户可通过 bridge-to-coder.sh 的第二个参数指定工具
 ring2_default_tool: claude
 ring3_feedback_questions: skills/your-skill-name/feedback-questions.sh
 

package/skills/req-mining/skill.yaml

@@ -9,6 +9,8 @@ tier: bundled
 ring1_protocol: skills/req-mining/domain.md
 ring1_artifacts_doc: ai-execution-doc.md
 ring2_bridge: scripts/bridge-to-coder.sh
+# Ring 2 默认工具：claude / opencode / codex / trae / cursor
+# 用户可通过 bridge-to-coder.sh 的第二个参数指定工具
 ring2_default_tool: claude
 ring3_feedback_questions: skills/req-mining/feedback-questions.sh
 

package/templates/user-config.json

@@ -0,0 +1,67 @@
+{
+  "_comment": "Telos 用户配置文件。安装后复制为 .telos-config.json 即可生效。",
+  "version": "1.4.0",
+
+  "skill_extraction": {
+    "_comment": "技能提取（无感模式）配置",
+    "auto_confirm_skill_save": false,
+    "soft_prompt_enabled": true,
+    "soft_prompt_max_per_session": 1,
+    "min_conversation_turns_for_soft_prompt": 6
+  },
+
+  "distillation": {
+    "_comment": "蒸馏（协议进化）配置",
+    "auto_confirm_distill": false,
+    "threshold": 3,
+    "quality_score_min": 0.6
+  },
+
+  "skill_loading": {
+    "_comment": "技能自动加载配置",
+    "auto_load_on_topic_match": true,
+    "match_confidence_threshold": 0.6,
+    "silent_load": true
+  },
+
+  "codewords": {
+    "_comment": "暗号系统。用户说出别名中的任意一个词即触发对应动作。可自由增删改。",
+    "enabled": true,
+    "hint_on_start": true,
+    "save": {
+      "description": "保存当前对话中的技能知识",
+      "action": "skill_save",
+      "aliases": ["记下来", "保存", "存一下", "存起来", "归档", "收入囊中"]
+    },
+    "list": {
+      "description": "查看已掌握的所有技能",
+      "action": "skill_list",
+      "aliases": ["我都有什么技能", "看看家底", "技能库", "有哪些技能", "翻翻看"]
+    },
+    "load": {
+      "description": "手动加载某个领域的技能到当前对话",
+      "action": "skill_load",
+      "aliases": ["加载技能", "唤起", "拿出来"]
+    },
+    "delete": {
+      "description": "删除某个技能（需确认）",
+      "action": "skill_delete",
+      "aliases": ["删掉", "移除", "清空这个"]
+    },
+    "distill": {
+      "description": "手动触发协议蒸馏（从反馈中学习进化）",
+      "action": "distill",
+      "aliases": ["蒸馏", "进化", "复盘", "总结提升"]
+    },
+    "telos": {
+      "description": "启动 Telos 飞轮",
+      "action": "telos_start",
+      "aliases": ["启动飞轮", "开始分析", "专家会诊"]
+    },
+    "show_codewords": {
+      "description": "显示所有可用暗号",
+      "action": "show_codewords",
+      "aliases": ["暗号大全", "有哪些暗号", "对暗号", "暗号列表", "help"]
+    }
+  }
+}