@vima_tech/telos 1.4.0 → 1.4.1

package/CLAUDE.md

@@ -0,0 +1,449 @@
+# Telos：对话驱动的个人能力操作系统
+
+**Towards who you become. — 走向你将成为的那个人。**
+
+你的对话在积累。每次有收获的对话都被提炼为技能，下次同类话题自动加载，
+从你已有的基础出发，而不是从零开始。
+
+遇到复杂问题时，用 `@{skill}` 召集领域专家协议入场，多视角独立分析，交叉质疑，综合输出。
+执行后的反馈流入飞轮，驱动每个专家协议从失败中持续进化。
+
+**两套并行的成长引擎：**
+- **你的技能成长**：任意对话的程序性知识 → 提炼存入 `skills/{domain}/` → 下次自动加载
+- **专家协议进化**：执行反馈 → Ring 3 蒸馏 → 协议更准确
+
+现有 AI 记忆的主语是系统。这里两套引擎的主语分别是：你，和协议本身。
+
+**技能库是你的能力积累，飞轮是协议的进化基础设施，@skill 群聊是多专家协作界面。**
+
+---
+
+## Telos 激活
+
+**用户通过以下任意方式激活 Telos：**
+
+| 方式 | 示例 |
+|---|---|
+| 斜杠命令（推荐） | `/telos` |
+| 英文触发词 | `tos`、`telos`、`start telos` |
+| 中文触发词 | `开始 telos`、`开启 telos`、`启动 telos` |
+| 直接提供材料 | 粘贴文档 / 文件路径 / URL |
+
+检测到以上任意信号时，立即执行 `.claude/commands/telos.md` 中的激活流程。
+
+**默认不激活：** 打开会话后不主动问候或启动，等待用户给出激活信号。
+
+---
+
+## 使用模式：无感模式 vs 命令模式
+
+Telos 支持两种使用模式，用户可自由切换：
+
+### 无感模式（推荐，默认）
+
+**不需要记住任何命令。** 像和豆包日常对话一样，通过"暗号"触发功能：
+
+```
+用户：今天研究了下红烧肉的技巧，先煎后炖是关键
+...（对话继续）...
+用户：这个方法挺好的，记下来吧
+系统：✓ 已保存到 skills/cooking/braising.md，下次烹饪话题自动加载。
+```
+
+**什么是暗号？**
+暗号是用户和 Telos 之间的"约定暗语"。说出暗号，对应功能立即触发。暗号可自定义。
+
+**默认暗号：**
+| 说这些词 | 触发功能 |
+|---|---|
+| `记下来`、`保存`、`存一下`、`存起来`、`归档` | 保存当前对话为技能 |
+| `我都有什么技能`、`看看家底`、`技能库` | 查看技能库 |
+| `暗号大全`、`对暗号`、`有哪些暗号` | 查看所有暗号 |
+| `启动飞轮`、`开始分析` | 激活 Telos 分析模式 |
+
+**自定义暗号：**
+```
+用户：新增暗号
+系统：请告诉我暗号名称、触发词、对应动作...
+```
+
+暗号系统详情见 `skills/_kernel/codewords.md`，管理命令见 `.claude/commands/codeword.md`。
+无感模式详情见 `skills/_kernel/skill-extraction.md`。
+
+### 命令模式（精确控制）
+
+适合明确意图、批量整理的场景：
+
+```
+/skill save cooking/braising    # 精确保存
+/skill list                     # 查看技能库
+/skill load cooking             # 手动加载领域
+/codeword list                  # 查看所有暗号
+/codeword add                   # 新增暗号
+```
+
+命令模式详情见 `.claude/commands/skill.md` 和 `.claude/commands/codeword.md`。
+
+---
+
+## @Skill 路由与纠正协议
+
+`@{skill}` 语法在飞轮中有两种语义，优先级从高到低依次判断：
+
+### 1. 即时纠正（Mini-蒸馏）
+
+消息中包含 `@{skill}` 且后续文本带有**纠正信号词**时，触发即时蒸馏，不执行材料分析：
+
+纠正信号词：`纠正`、`你漏掉`、`漏掉`、`补充`、`修正`、`应该`、`下次`、`记住`、`wrong`、`missed`
+
+```
+@req-mining 你漏掉了需求优先级排序
+@req-mining 下次先问行业背景再做分析
+```
+
+触发后读取 `skills/_kernel/distillation.md` 的 **Mini-蒸馏协议** 章节执行，
+绕过日志积累门槛，直接写入该 Skill 的 memory 或 domain。
+
+### 2. 群聊路由（激活 / 切换 Skill）
+
+不含纠正信号词时，`@{skill}` 为路由指令：
+
+| 语法 | 行为 |
+|---|---|
+| `tos @req-mining @code-review 文档` | 多 Skill 群聊，隔离顺序分析（默认） |
+| `tos @req-mining @code-review 文档 --parallel` | 多 Skill 真并行，派生独立子任务 |
+| `tos @all 文档` | 激活所有已安装 Skill |
+| `@req-mining 分析一下` | 会话中切换 / 新增 Skill |
+| `@?` 或 `@list` | 列出所有可用 Skill |
+
+**解析规则：**
+1. 提取消息中全部 `@word` token（word = 字母/数字/连字符）
+2. `@all` 展开为所有已安装 Skill（排除 `_` 前缀目录）
+3. 逐个在 `skills/` 目录查找；不存在的输出 `❌ Skill '@{name}' 不存在` 并列出可用 Skill
+4. 全部匹配成功 → 进入群聊模式（见下节）
+
+---
+
+## 群聊模式（Multi-Skill Group Chat）
+
+多个 `@skill` 同时激活时，系统进入群聊模式：
+
+```
+━━━ 群聊开启 | Skills: @req-mining @code-review | 项目: {id} ━━━
+```
+
+**每轮交互流程：**
+
+1. 用户提供材料或问题
+2. 每个 Skill 依次用自己的 `domain.md` 视角独立分析，输出以 `[@{skill}]` 标头区分：
+
+```
+[@req-mining]
+  识别到 5 个核心需求…
+  信息缺口：预算范围未明确
+
+[@code-review]
+  可行性评估：需求 3 存在技术风险…
+  建议：先原型验证再排期
+```
+
+3. 全部 Skill 发言后，输出 **综合视图**：
+
+```
+━━━ 综合视图 ━━━
+共识：…
+分歧：@req-mining 认为… / @code-review 认为…
+建议下一步：…
+━━━━━━━━━━━━━━━━
+```
+
+4. 状态行更新为：
+```
+━━━ [Ring 1] | Skills: @a @b | 项目: {id} | 假设: N项 ━━━
+```
+
+**Skill 间交叉引用：**
+Skill 发言中可引用其他 Skill 的结论，格式：`（参见 @req-mining 的第 2 点）`
+
+**飞轮基础设施仍在运行：**
+群聊中每轮反馈、纠正均写入 `episodic-logs/`，Ring 3 蒸馏照常积累。
+`@skill 纠正` 语法在群聊中同样有效，定向更新被纠正的 Skill。
+
+---
+
+## 目录结构
+
+```
+CLAUDE.md                         ← 你正在读的文件（系统引导）
+install.sh                        ← 一键安装脚本
+.claude/commands/               ← Claude Code 自定义命令
+  telos.md                        ← /telos 激活飞轮
+  skill.md                        ← /skill 技能库管理（自然语言 + 命令双模式）
+  add-skill.md                    ← /add-skill 创建新协议 Skill
+  codeword.md                     ← /codeword 暗号管理
+.opencode/commands/             ← OpenCode 自定义命令（与 Claude Code 格式兼容）
+  telos.md
+  skill.md
+  add-skill.md
+  codeword.md
+scripts/
+  auto-distill.sh                 ← Ring 3：检查蒸馏触发条件
+  feedback-hook.sh                ← Ring 2→3：收集执行反馈
+  bridge-to-coder.sh              ← Ring 1→2：产物→执行工具
+  telos-install.sh                ← Skill 包管理工具
+skills/                           ← 统一技能库（两类 Skill 共存）
+  _kernel/
+    distillation.md               ← 飞轮蒸馏协议（协议 Skill 进化引擎）
+    skill-extraction.md           ← 用户技能提炼协议（支持无感模式）
+  _template/                      ← 新建协议 Skill 的脚手架模板
+    skill.yaml
+    domain.md
+    feedback-questions.sh
+  req-mining/                     ← 内置协议 Skill：需求挖掘与落地
+    skill.yaml                    ← Skill 元数据（标识为协议类）
+    domain.md                     ← Ring 1 分析协议
+    artifacts.md                  ← 产物规格
+    feedback-questions.sh         ← Skill 专属反馈问题
+    memory/
+      failure-patterns.md         ← 已知失败模式（常驻加载）
+    industry/
+      erp.md                      ← ERP 行业包
+  _index.md                       ← 技能索引（对话开始时扫描，含两类）
+  {domain}/                       ← 用户知识 Skill（如 cooking/、writing/）
+    {name}.md                     ← 具体技能文件（无 skill.yaml）
+templates/
+  state.json                      ← 项目状态模板
+projects/                         ← 项目状态（Git 忽略）
+episodic-logs/                    ← 事件日志（Git 忽略）
+.distill-needed/                  ← 蒸馏触发标记（Git 忽略）
+```
+
+---
+
+## 飞轮架构
+
+```
+Ring 1  用户通过 @{skill} 召集 Skill 入场
+          ↓ 提供材料（文本 / 文件 / URL）
+        Skill 分析协议（skills/{skill}/domain.md）
+          ↓ 产物（含假设清单 + 信息缺口）+ 多 Skill 综合视图
+Ring 2  scripts/bridge-to-coder.sh
+          ↓ 注入产物到执行工具
+        执行工具工作（写入 .telos-feedback.json）
+          ↓
+        scripts/feedback-hook.sh --auto
+          ↓ 写入 episodic-logs/
+Ring 3  积累 ≥3 条高质量反馈 / 或 @skill 即时纠正
+          ↓
+        蒸馏协议（skills/_kernel/distillation.md）
+          ↓ 展示预览，单次 y/n → 更新 skills/ + memory/
+          ↓
+        Skill 下次分析更准确 ← 飞轮闭合
+```
+
+---
+
+## 启动步骤
+
+**每次会话启动时，首先执行 Step 0：**
+
+```
+Step 0（必须，优先于一切）：检查 .distill-needed/ 目录
+  → 目录下有文件（如 .distill-needed/proj_xxx）
+  → 立即读取 skills/_kernel/distillation.md
+  → 对每个标记的项目执行蒸馏（展示预览，单次 y/n 确认）
+  → 蒸馏完成后删除对应标记文件
+  → 所有标记处理完毕后，继续正常会话
+```
+
+**用户发出第一条消息后（技能感知加载，每次会话，静默执行）：**
+
+```
+Step S（技能加载，在响应前完成）：
+  → 读取 skills/_index.md
+  → 从用户消息提取主题关键词（不需用户感知）
+  → 匹配 _index.md 中的 domain 和 tags（置信度 > 0.6 才加载）
+  → 若有匹配：读取对应技能文件，以用户已掌握为前提展开对话
+  → 若无匹配：正常对话；对话末检测到程序性知识则触发软提示
+  → 不向用户输出加载过程（静默完成）
+```
+
+**用户激活飞轮后（Ring 1）：**
+
+```
+1. 读取已召集 Skill 的 memory 文件（常驻，必须）
+2. 读取 skill.yaml，加载对应 domain.md
+3. 根据材料内容判断是否加载行业包
+4. 检查 projects/{project_id}/state.json
+   - 存在 → 恢复上次会话状态
+   - 不存在 → 从 templates/state.json 创建，写入 skills 字段
+5. 执行 domain.md 中的分析协议（群聊时各 Skill 独立执行）
+6. 输出分析结果 + 信息缺口清单 + 综合视图（群聊时）
+7. 加载 skills/{skill}/artifacts.md，生成产物
+8. 通过 Bash 工具直接调用：
+   ./scripts/bridge-to-coder.sh {project_id} {tool}
+```
+
+---
+
+## 会话中的文件操作
+
+- 每轮对话后：更新 `projects/{project_id}/state.json`（含 `skills` 字段）
+- 关键事件：追加到 `episodic-logs/{project_id}.jsonl`
+- 蒸馏完成后：删除 `.distill-needed/{project_id}` 标记文件
+
+---
+
+## Ring 3 蒸馏触发条件
+
+```
+□ 同一项目积累 ≥3 条 quality_score≥0.6 的反馈事件
+□ 同类干预事件跨项目出现 ≥3 次
+□ 用户说"蒸馏"、"更新skill"、"从日志学习"
+□ 用户输入 @{skill} 含纠正信号词（即时 Mini-蒸馏）
+```
+
+触发后读取 `skills/_kernel/distillation.md`，执行蒸馏协议（或 Mini-蒸馏协议）。
+
+---
+
+## 关键协议
+
+### 状态文件路径
+```
+projects/{project_id}/state.json      ← 含 skills 字段（列表）
+projects/{project_id}/artifacts/      ← 产物存放位置
+```
+
+`project_id` 由用户提供或自动生成（格式：`proj_YYYYMMDD_NN`）
+
+### 每轮状态行
+```
+━━━ [Ring 1/2/3] | Skills: @{a} @{b} | 项目：{project_id} | 假设：X项 ━━━
+```
+
+### 未覆盖决策协议
+遇到 Skill 未覆盖的场景时，追加到 `uncovered_decisions`，输出 `⚠️ L2 告警`。
+
+---
+
+## Skill 管理
+
+```bash
+/skill list              # 列出已安装 Skill
+/skill add code-review   # 从注册表安装新 Skill
+/skill update            # 更新所有 Skill
+/add-skill               # 交互式创建新 Skill
+/codeword list           # 查看所有暗号
+/codeword add            # 新增暗号
+```
+
+**自然语言等价（暗号）：**
+```
+"我都有什么技能" / "看看家底"   → /skill list
+"暗号大全" / "对暗号"          → /codeword list
+"安装 code-review"            → /skill add code-review
+"创建一个新 skill"            → /add-skill
+```
+
+---
+
+## Git 规范
+
+```bash
+# 协议 Skill 进化提交（蒸馏后）
+git add skills/ memory/
+git commit -m "distill({skill}): {描述} (from {project_id})"
+
+# 用户知识 Skill 提炼提交
+git add skills/
+git commit -m "skill({domain}/{name}): {描述}"
+```
+
+---
+
+## .gitignore 内容
+
+```
+projects/*/
+episodic-logs/
+.distill-needed/*
+!.distill-needed/.gitkeep
+*.log
+.DS_Store
+```
+
+注意：`skills/` 目录**不在** gitignore 中——技能库是个人能力资产，应跟踪版本。
+
+---
+
+## 技能成长系统
+
+这是 Telos 的第二条成长轴线。Skill 进化的主语是 Skill；技能成长的主语是你。
+
+**两者的根本差异：**
+
+| | 协议 Skill 进化（现有飞轮）| 用户技能成长（新增）|
+|---|---|---|
+| 主语 | 协议 Skill | 用户 |
+| 知识类型 | Skill 分析流程 | 用户程序性知识 |
+| 触发条件 | ≥3 条质量事件 | 任意对话 + 用户确认 |
+| 存储位置 | `skills/{skill}/domain.md` | `skills/{domain}/{name}.md` |
+| 加载时机 | @skill 激活时 | 任意对话，按主题匹配 |
+| 跨域 | 否（每个 Skill 独立）| 是（烹饪→谈判→写作均可）|
+
+**触发方式（三种，任选）：**
+
+```
+主动：  /skill save [主题]
+        保存这个技巧 / 记住这个方法 / 记下来 / 存一下
+被动：  对话中检测到程序性知识 → 软提示（每次会话最多一次）
+后验：  /skill save（无参数，提炼完整对话）
+```
+
+**技能文件格式：**
+
+```markdown
+---
+name: braising
+domain: cooking
+tags: [meat, slow-cook, chinese]
+created: 2026-05-17
+last_updated: 2026-05-17
+conversation_count: 1
+---
+
+# 炖煮技法（红烧 / 炖）
+
+## 核心原则
+- 焦糖化先行：肉先煎至表面焦糖化，再加水
+
+## 关键技巧
+- 冰糖炒糖色：小火 → 琥珀色立刻下肉
+- 老抽:生抽 = 1:3（上色:提鲜）
+
+## 常见陷阱
+- 大火炖肉：肉柴、汤浑，文火才是正解
+
+## 待探索
+- 压力锅 vs 砂锅的口感差异
+```
+
+**完整协议：** 见 `skills/_kernel/skill-extraction.md`
+**命令参考：** 见 `.claude/commands/skill.md`
+
+---
+
+## 两类 Skill 对照
+
+`skills/` 目录下共存两类技能，通过是否有 `skill.yaml` 区分：
+
+| | 协议 Skill | 知识 Skill |
+|---|---|---|
+| 典型例子 | `req-mining`、`code-review` | `cooking/braising`、`writing/technical` |
+| 有 `skill.yaml` | ✓ | ✗ |
+| 包含 `domain.md` | ✓ | ✗ |
+| 激活方式 | `@req-mining 分析这份文档` | 对话主题匹配后自动加载 |
+| 进化方式 | Ring 3 蒸馏 → 更新 domain.md | `/skill save` 或软提示 → 追加技巧 |
+| 生命周期 | 安装/卸载（`/skill add/remove`）| 积累/查阅（`/skill save/show`）|
+| 主语 | Skill 的能力 | 用户的能力 |

package/README.md

@@ -73,9 +73,12 @@ Synthesis   →  consensus on scope · diverge on timeline · prototype first
 ```bash
 npm install -g @vima_tech/telos
 telos new my-project
-cd my-project && claude
+cd my-project && claude    # or codex / opencode / trae / cursor
 ```
 
+> Telos works with Claude Code, OpenCode, Codex, Trae, Cursor, and other AI coding tools.
+> Install any one to get started.
+
 **Embed into an existing project:**
 
 ```bash
@@ -85,7 +88,14 @@ curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | b
 curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | bash -s req-mining
 ```
 
-Both include `skills/`, `scripts/`, `CLAUDE.md`, and the `telos` / `tos` commands. After installation, open Claude Code and type `tos` to start.
+Both include `skills/`, `scripts/`, `CLAUDE.md`, and the `telos` / `tos` commands.
+
+**Custom commands support:**
+- Claude Code: `.claude/commands/*.md` slash commands
+- OpenCode: `.opencode/commands/*.md` slash commands (compatible format, auto-installed)
+- Codex / Trae / Cursor: use natural language codewords + CLI commands
+
+After installation, open your AI coding tool and type `tos` or `/telos` to start.
 
 ---
 

package/README.zh.md

@@ -26,18 +26,50 @@
 
 ## Telos 做什么
 
-**技能库** — 每次有收获的对话都可以提炼为技能文件。下次同类话题出现，Telos 静默加载你已有的知识，从你上次停下的地方继续——不限于编程，任何领域都可以。
+### 像聊天一样积累技能（无感模式）
+
+**不需要记命令。** 像和豆包日常对话一样，通过"暗号"触发功能：
+
+```
+你：今天研究了下红烧肉的技巧，先煎后炖是关键，冰糖炒糖色要小火...
+...（对话继续）...
+你：这个方法挺好的，记下来吧
+Telos：✓ 已保存。下次聊烹饪时自动加载。
+```
+
+**什么是暗号？**
+暗号是你和 Telos 之间的"约定暗语"。说出任意一个暗号，对应功能立即触发。你可以随时新增、修改、删除自己的暗号。
+
+**默认暗号：**
+| 说这些词 | 触发功能 |
+|---|---|
+| `记下来`、`保存`、`存一下`、`存起来` | 保存当前对话为技能 |
+| `我都有什么技能`、`看看家底`、`技能库` | 查看你的技能库 |
+| `暗号大全`、`对暗号`、`有哪些暗号` | 查看所有可用暗号 |
+| `启动飞轮`、`开始分析`、`专家会诊` | 激活 Telos 分析模式 |
+
+**自定义暗号：**
+```
+你：新增暗号
+Telos：请告诉我暗号名称、触发词、对应动作...
+```
+
+### 技能库自动加载
+
+每次对话开始时，Telos 静默扫描你的技能库。聊到相关话题时，自动加载你已有的知识：
 
 ```
 第一次会话：和 Claude 研究红烧肉的技巧
-→ /skill save   →   skills/cooking/braising.md
+→ "记下来"   →   skills/cooking/braising.md
 
 第二次会话："炖牛腩怎么做？"
 → Telos 静默加载 braising.md
 → Claude 从你已有的基础出发，不从零开始
 ```
 
-**多专家分析** — 用 `@skill` 把领域专家协议召入同一会话，各自独立分析你的材料，Telos 输出综合视图：共识、分歧、下一步建议。
+### 多专家分析（命令模式）
+
+用 `@skill` 把领域专家协议召入同一会话，各自独立分析你的材料，Telos 输出综合视图：
 
 ```
 tos @req-mining @code-review 帮我看这份需求文档
@@ -46,7 +78,9 @@ code-review →  需求 3 存在技术风险 · 建议先做原型再排期
 综合视图    →  范围上达成共识 · 时间线存在分歧 · 先做原型
 ```
 
-**飞轮** — 专家协议从执行反馈中自动进化。即时纠正：`@req-mining 你漏掉了优先级排序` — 直接写入记忆，无需等待积累门槛。
+### 飞轮进化
+
+专家协议从执行反馈中自动进化。即时纠正：`@req-mining 你漏掉了优先级排序` — 直接写入记忆，无需等待积累门槛。
 
 ---
 
@@ -54,6 +88,9 @@ code-review →  需求 3 存在技术风险 · 建议先做原型再排期
 
 | | |
 |---|---|
+| **暗号系统** | 像对暗号一样触发功能，可自定义专属暗号 |
+| **无感模式** | 像聊天一样积累技能，无需记命令 |
+| **多工具支持** | Claude Code / OpenCode / Codex / Trae / Cursor |
 | **技能成长** | 对话 → 结构化可复用技能，下次会话自动加载 |
 | **不限领域** | 烹饪、谈判、写作、编程——技能库不只是给程序员用的 |
 | **`@skill` 路由** | `tos @req-mining @code-review 文档` — 一行命令，多位专家 |
@@ -74,9 +111,12 @@ code-review →  需求 3 存在技术风险 · 建议先做原型再排期
 ```bash
 npm install -g @vima_tech/telos
 telos new my-project
-cd my-project && claude
+cd my-project && claude    # 或使用 codex / opencode
 ```
 
+> Telos 支持 Claude Code、OpenCode、Codex、Trae、Cursor 等 AI 编程工具。
+> 安装任意一个即可使用。
+
 **嵌入现有项目：**
 
 ```bash
@@ -86,18 +126,44 @@ curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | b
 curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | bash -s req-mining
 ```
 
-两种方式均包含 `skills/`、`scripts/`、`CLAUDE.md` 以及 `telos` / `tos` 命令。安装完成后，打开 Claude Code，输入 `tos` 即可启动。
+两种方式均包含 `skills/`、`scripts/`、`CLAUDE.md` 以及 `telos` / `tos` 命令。
+
+**自定义命令支持：**
+- Claude Code：`.claude/commands/*.md` 斜杠命令
+- OpenCode：`.opencode/commands/*.md` 斜杠命令（格式兼容，自动安装）
+- Codex / Trae / Cursor：通过自然语言暗号 + CLI 命令使用
+
+安装完成后，打开你的 AI 编程工具，输入 `tos` 或 `/telos` 即可启动。
 
 ---
 
 ## 使用方式
 
+### 无感模式（推荐）
+
+```
+# 日常对话中随时说暗号
+"记下来"                    # 保存当前对话的技巧
+"这个方法挺好的"            # 暗示保存，系统会询问
+"我都有什么技能"            # 查看技能库
+"整理一下刚才聊的"          # 汇总保存
+"暗号大全"                  # 查看所有可用暗号
+"新增暗号"                  # 自定义专属暗号
+
+# 不需要记任何斜杠命令
+```
+
+### 命令模式（精确控制）
+
+Claude Code / OpenCode 用户可用斜杠命令：
 ```bash
 # 积累你的技能
 /skill save                         # 把当前对话提炼为技能
 /skill save cooking/braising        # 指定领域和名称
 /skill list                         # 查看你已掌握的技能
 /skill load negotiation             # 手动加载某领域到当前上下文
+/codeword list                      # 查看所有暗号
+/codeword add                       # 新增暗号
 
 # 多专家分析
 tos @req-mining 帮我看这份 PRD...              # 单专家分析
@@ -110,6 +176,8 @@ tos @all 帮我看这份...                         # 激活所有已安装 Skil
 @?                                            # 列出可用 Skill
 ```
 
+Codex / Trae / Cursor 用户：斜杠命令不可用，请使用自然语言暗号或 `telos` CLI。
+
 ---
 
 ## 两类 Skill
@@ -142,7 +210,7 @@ Ring 3  ≥3 条反馈，或 @skill 即时纠正
           → 下次分析更准确
 ```
 
-唯一需要人工操作的是蒸馏差异预览的一次 y/n 确认。
+唯一需要人工操作的是蒸馏差异预览的一次 y/n 确认（可在 `.telos-config.json` 中开启自动确认）。
 
 ---
 
@@ -158,6 +226,31 @@ Ring 3  ≥3 条反馈，或 @skill 即时纠正
 
 ---
 
+## 配置
+
+安装后生成 `.telos-config.json`，可自定义行为：
+
+```json
+{
+  "skill_extraction": {
+    "auto_confirm_skill_save": false,    // 是否自动确认保存（无需预览）
+    "soft_prompt_enabled": true           // 是否启用对话结束时的软提示
+  },
+  "distillation": {
+    "auto_confirm_distill": false        // 是否自动确认蒸馏
+  },
+  "codewords": {
+    "enabled": true,                     // 是否启用暗号系统
+    "hint_on_start": true,               // 启动时是否提示常用暗号
+    "save": {
+      "aliases": ["记下来", "保存", "存一下", "收入囊中"]
+    }
+  }
+}
+```
+
+---
+
 ## 开源贡献
 
 - **新 Skill** — PR 到 `skills/your-skill-name/`