@vima_tech/telos 1.4.0 → 1.4.1

package/.claude/commands/add-skill.md

@@ -0,0 +1,180 @@
+# 创建新 Skill
+
+引导用户快速创建一个飞轮 Skill 包，并注册到本地注册表。
+
+---
+
+## Step 1：收集基本信息
+
+向用户提出以下问题（合并为一次输出，用户可逐条回答）：
+
+```
+━━━ 新建 Skill ━━━
+
+请提供以下信息（直接回答即可）：
+
+1. Skill 名称（英文 kebab-case，如 code-review）：
+2. 一句话描述（中文）：
+3. 主要使用场景（一段话，描述什么情况下触发这个 agent）：
+4. 激活触发词（逗号分隔，用户说这些词时自动加载）：
+5. 是否需要产物规格文件 artifacts.md？(y/n，默认 y)
+6. 是否需要行业包目录（如针对特定行业的问题集）？(y/n，默认 n)
+```
+
+收到所有信息后，进入 Step 2。
+
+---
+
+## Step 2：创建目录结构
+
+设 `{skill}` 为用户输入的 Skill 名称（如 `code-review`）。
+
+**依次创建以下文件，使用 Write 工具：**
+
+### 2.1 `skills/{skill}/skill.yaml`
+
+参考 `skills/_template/skill.yaml` 结构，用用户提供的信息填写：
+
+```yaml
+name: {skill}
+version: 0.1.0
+description: {用户输入的描述}
+author: ""
+license: MIT
+tier: workspace
+
+# 飞轮配置
+ring1_protocol: skills/{skill}/domain.md
+ring1_artifacts_doc: execution-doc.md
+ring2_bridge: scripts/bridge-to-coder.sh
+ring2_default_tool: claude
+ring3_feedback_questions: skills/{skill}/feedback-questions.sh
+
+# 激活触发词
+triggers:
+{用户输入的触发词，每行一个，格式：  - "触发词"}
+
+# 初始记忆文件
+memory:
+  - skills/{skill}/memory/failure-patterns.md
+
+# 产物规格（如有 artifacts.md）
+artifacts:
+  spec: skills/{skill}/artifacts.md
+  outputs:
+    - name: 执行文档
+      file: execution-doc.md
+```
+
+### 2.2 `skills/{skill}/domain.md`
+
+参考 `skills/_template/domain.md` 结构，将以下占位符替换：
+- `[Skill 名称]` → 用户提供的描述
+- `描述在什么情况下使用此 skill` → 用户提供的使用场景
+- `skills/your-skill-name/artifacts.md` → `skills/{skill}/artifacts.md`
+- skill_id、your-skill-name → 对应值
+
+### 2.3 `skills/{skill}/feedback-questions.sh`
+
+参考 `skills/_template/feedback-questions.sh`，将注释中的 skill 名称替换为 `{skill}`。
+
+### 2.4 `skills/{skill}/memory/failure-patterns.md`
+
+创建初始空文件：
+
+```markdown
+# {Skill 名称} 失败模式库
+
+**类型：** External Memory（陈述性知识）
+**加载时机：** 每次 {skill} 会话常驻加载
+**更新方式：** 蒸馏后自动追加，不手动编辑
+
+---
+
+## 模式列表
+
+（暂无记录，蒸馏后自动填充）
+
+---
+
+*本文件由蒸馏流程自动维护，请勿手动编辑已有条目。*
+```
+
+### 2.5 `skills/{skill}/artifacts.md`（仅当用户选 y）
+
+创建带基础结构的产物规格文件：
+
+```markdown
+---
+name: {skill}-artifacts
+skill_id: {skill_id}
+version: 0.1.0
+description: >
+  {agent} 产物生成规格。定义分析完成后输出的文档结构。
+---
+
+# 产物生成规格
+
+---
+
+## 输出前自检
+
+```
+□ 分析是否完整覆盖所有输入材料？
+□ 假设是否已标注？
+□ 信息缺口是否已列出？
+```
+
+---
+
+## 产物 1：执行文档
+
+**面向：** 执行工具（AI 编程助手）
+
+```
+1. 任务概述
+2. 具体要求（逐条列出）
+3. 约束条件
+4. 验收标准
+5. 未覆盖情况处理规则
+```
+```
+
+---
+
+## Step 3：注册到本地注册表
+
+通过 Bash 工具执行：
+
+```bash
+./scripts/telos-install.sh publish {skill}
+```
+
+---
+
+## Step 4：完成提示
+
+输出：
+
+```
+━━━ Skill 创建完成 ━━━
+
+  skills/{skill}/
+  ├── skill.yaml          ✓
+  ├── domain.md           ✓（待补充分析协议）
+  ├── feedback-questions.sh ✓
+  ├── artifacts.md        ✓（待补充产物规格）
+  └── memory/
+      └── failure-patterns.md ✓
+
+已注册到本地注册表（available.json）
+
+下一步：
+  1. 编辑 skills/{skill}/domain.md，填写具体的分析步骤
+  2. 编辑 skills/{skill}/artifacts.md，定义产物结构
+  3. 输入 /telos 选择并激活此 skill
+
+发布到官方注册表（可选）：
+  telos publish {skill}   # 已执行，再提交 PR 即可对外共享
+━━━━━━━━━━━━━━━━━━━━━━
+```

package/.claude/commands/codeword.md

@@ -0,0 +1,166 @@
+# /codeword — 暗号管理
+
+管理你的 Telos 暗号系统。暗号是自然语言触发词，让你无需记忆斜杠命令。
+
+---
+
+## 子命令
+
+| 命令 | 说明 |
+|---|---|
+| `/codeword list` | 列出所有暗号 |
+| `/codeword add` | 新增自定义暗号 |
+| `/codeword edit <id>` | 修改指定暗号 |
+| `/codeword remove <id>` | 删除指定暗号 |
+| `/codeword reset` | 恢复默认暗号 |
+
+---
+
+## /codeword list
+
+列出当前配置的所有暗号及其别名。
+
+**输出格式：**
+
+```
+━━━ 暗号大全 ━━━
+
+💾 save — 保存当前对话中的技能知识
+  别名：记下来、保存、存一下、存起来、归档、收入囊中
+
+📚 list — 查看已掌握的所有技能
+  别名：我都有什么技能、看看家底、技能库、有哪些技能、翻翻看
+
+🚀 telos — 激活 Telos 分析模式
+  别名：启动飞轮、开始分析、专家会诊
+
+...
+
+━━━━━━━━━━━━━━━━━━━━
+```
+
+**执行步骤：**
+1. 读取 `.telos-config.json` → `codewords`
+2. 遍历所有暗号，按类别分组展示
+3. 输出别名列表
+
+---
+
+## /codeword add
+
+新增一个自定义暗号。
+
+**交互流程：**
+
+```
+━━━ 新增暗号 ━━━
+
+1. 暗号ID（英文，唯一标识，如 my-save）：
+2. 触发词（说哪些词时触发，可多组，用逗号/空格分隔）：
+3. 对应动作：
+   - skill_save    保存技能
+   - skill_list    列出技能
+   - skill_load    加载技能
+   - skill_delete  删除技能
+   - distill       触发蒸馏
+   - telos_start   启动飞轮
+4. 描述（一句话说明）：
+
+━━━━━━━━━━━━━━━━━━━━
+```
+
+**写入 `.telos-config.json`：**
+
+```json
+"my_save": {
+  "description": "我的保存暗号",
+  "action": "skill_save",
+  "aliases": ["收入囊中", "收好", "mark"]
+}
+```
+
+**规则：**
+- 暗号ID只能包含英文字母、数字、连字符、下划线
+- 别名不能为空，至少1个
+- 不能与现有暗号ID重复
+- 别名可以与其它暗号重复（最后匹配的优先，但建议避免）
+
+---
+
+## /codeword edit <id>
+
+修改指定暗号。
+
+```
+/codeword edit save
+```
+
+**输出：**
+```
+━━━ 修改暗号：save ━━━
+
+当前配置：
+  描述：保存当前对话中的技能知识
+  动作：skill_save
+  别名：记下来、保存、存一下、存起来、归档、收入囊中
+
+请选择操作：
+  1. 添加别名
+  2. 删除别名
+  3. 修改描述
+  4. 修改动作
+  5. 完成
+```
+
+**别名操作：**
+- 添加：输入新别名，自动追加
+- 删除：列出带编号的别名，用户输入编号删除
+
+---
+
+## /codeword remove <id>
+
+删除指定暗号。
+
+```
+/codeword remove my_save
+```
+
+**确认提示：**
+```
+确认删除暗号 "my_save"？
+其触发词将失效：收入囊中、收好、mark
+(y/n)
+```
+
+**规则：**
+- 默认暗号（save、list、load、delete、distill、telos、show_codewords）可以删除，但给出警告
+- 删除后该暗号立即失效
+- 删除默认暗号后，可用 `/codeword reset` 恢复
+
+---
+
+## /codeword reset
+
+恢复所有默认暗号（保留自定义暗号，或选择全部重置）。
+
+```
+━━━ 恢复默认暗号 ━━━
+
+请选择：
+  1. 仅恢复被删除的默认暗号（保留自定义暗号）
+  2. 完全重置为出厂设置（删除所有自定义暗号）
+  3. 取消
+```
+
+---
+
+## 自然语言等价
+
+| 自然语言 | 命令 |
+|---|---|
+| 暗号大全 / 对暗号 / 有哪些暗号 | `/codeword list` |
+| 新增暗号 / 加个暗号 | `/codeword add` |
+| 改暗号 / 修改暗号 | `/codeword edit` |
+| 删暗号 / 去掉暗号 | `/codeword remove` |
+| 恢复默认暗号 | `/codeword reset` |

package/.claude/commands/skill.md

@@ -0,0 +1,172 @@
+# /skill — 技能库统一管理
+
+`skills/` 目录下有两类 Skill，本命令统一管理：
+
+- **协议 Skill**（有 `skill.yaml`）：req-mining、code-review 等结构化分析协议
+- **知识 Skill**（无 `skill.yaml`）：从对话提炼的程序性知识，如 cooking/braising
+
+**本命令同时支持：命令模式 + 自然语言模式。**
+
+---
+
+## 自然语言模式（无感使用）
+
+用户不需要记住任何命令，像日常聊天一样即可管理技能：
+
+| 用户自然语言 | 系统行为 |
+|---|---|
+| "记下来" / "保存" / "存一下" / "整理一下" | 触发当前对话的技能保存 |
+| "我都有什么技能" / "看看我的技能库" | 列出所有技能 |
+| "刚才聊的存起来" | 保存最近对话的主题 |
+| "更新一下烹饪技能" | 更新指定领域的技能 |
+| "删除这个技能" | 删除技能（需确认） |
+
+自然语言模式自动读取 `skills/_kernel/skill-extraction.md` 的无感模式协议执行。
+
+---
+
+## 子命令总览
+
+| 命令 | 类型 | 说明 |
+|---|---|---|
+| `/skill list` | 两类 | 列出所有 Skill（分类显示）|
+| `/skill show [name]` | 两类 | 查看指定 Skill 详情 |
+| `/skill add <name>` | 协议 | 从注册表安装协议 Skill |
+| `/skill update [name]` | 协议 | 更新协议 Skill |
+| `/skill remove <name>` | 协议 | 卸载协议 Skill |
+| `/skill save [主题]` | 知识 | 从当前对话提炼知识 Skill |
+| `/skill load [domain]` | 知识 | 手动加载某领域知识 Skill |
+| `/skill delete [domain/name]` | 知识 | 删除知识 Skill（需确认）|
+
+---
+
+## /skill list
+
+列出所有已安装的 Skill，分两类展示。
+
+**执行步骤：**
+1. 扫描 `skills/` 目录：有 `skill.yaml` → 协议 Skill；无 → 知识 Skill
+2. 读取 `skills/_index.md` 补充知识 Skill 的摘要
+
+**输出格式：**
+
+```
+━━━ 技能库 ━━━
+
+▶ 协议 Skills（2个已安装）
+  • req-mining   v1.0  —  需求挖掘与落地
+  • code-review  v0.3  —  代码审查分析
+
+📚 知识 Skills（3个）
+🍳 cooking
+  • braising     —  炖煮技法：焦糖化、火候、收汁  [2026-05-17]
+✍️ writing
+  • technical    —  技术文档：结构与清晰度  [2026-05-10]
+
+共 5 个 Skill
+━━━━━━━━━━━━━
+```
+
+---
+
+## /skill show [name]
+
+查看指定 Skill 详情。对协议 Skill 显示 skill.yaml + domain.md 摘要；对知识 Skill 显示完整内容。
+
+```
+/skill show req-mining          # 协议 Skill
+/skill show cooking/braising    # 知识 Skill
+```
+
+---
+
+## /skill add \<name\>
+
+从官方注册表安装新的协议 Skill。
+
+```bash
+./scripts/telos-install.sh add <name>
+```
+
+安装完成后提示：`✓ 已安装 @{name}，输入 /telos 激活`
+
+---
+
+## /skill update [name]
+
+```bash
+./scripts/telos-install.sh update [name]  # 省略 name 则更新全部
+```
+
+---
+
+## /skill remove \<name\>
+
+卸载协议 Skill（需确认）：
+
+```
+确认卸载 @req-mining？此操作将删除 skills/req-mining/ 目录。(y/n)
+```
+
+---
+
+## /skill save [主题]
+
+从当前对话提炼知识 Skill，保存到 `skills/{domain}/{name}.md`。
+
+**执行步骤：**
+
+1. 读取 `skills/_kernel/skill-extraction.md`
+2. 执行 **E-Step 1～5** 的完整提炼流程
+3. 若未提供 `[主题]`，Claude 自动推断领域和名称
+
+**示例：**
+```
+/skill save                    # 自动推断主题
+/skill save cooking/braising   # 指定领域和名称
+/skill save 红烧肉技巧          # 中文主题，自动映射到 cooking/braising
+```
+
+---
+
+## /skill load [domain]
+
+手动将某领域的知识 Skill 加载到当前对话上下文。
+
+```
+/skill load cooking      # 加载所有 cooking 知识技能
+/skill load negotiation  # 加载所有 negotiation 知识技能
+```
+
+**执行步骤：**
+1. 扫描 `skills/{domain}/`（无 skill.yaml 的文件）
+2. 读取并加载
+3. 输出：
+   ```
+   ✓ 已加载 cooking 知识技能：braising（{N}条技巧）、knife-skills（{N}条技巧）
+   接下来的对话将以你已掌握这些技巧为前提展开。
+   ```
+
+---
+
+## /skill delete [domain/name]
+
+删除知识 Skill（需确认）：
+
+```
+确认删除 cooking/braising？(y/n)
+```
+
+用户确认后删除文件并从 `skills/_index.md` 移除条目。
+
+---
+
+**别名与自然语言映射（暗号）：**
+- `保存这个技巧` / `记住这个方法` / `存到技能库` / `记下来` / `存一下` / `整理一下` → `/skill save`
+- `我都有什么技能` / `看看我的技能库` / `列出技能` / `看看家底` / `翻翻看` → `/skill list`
+- `/skill install` → `/skill add`
+- `/skill uninstall` → `/skill remove`
+- `暗号大全` / `对暗号` / `有哪些暗号` / `help` → `/codeword list`
+- `新增暗号` / `加个暗号` → `/codeword add`
+- `改暗号` / `修改暗号` → `/codeword edit`
+- `删暗号` / `去掉暗号` → `/codeword remove`