@vima_tech/telos 1.4.0 → 1.4.1

package/.claude/commands/telos.md

@@ -0,0 +1,299 @@
+# 启动自飞轮
+
+执行以下步骤，激活飞轮模式：
+
+---
+
+## Step 0：检查待蒸馏标记
+
+读取 `.distill-needed/` 目录。如果存在标记文件：
+- 列出所有待蒸馏项目
+- 询问用户是否现在处理，还是先处理新文档
+- 若用户选择现在蒸馏：读取 `skills/_kernel/distillation.md`，对每个标记项目执行蒸馏协议（展示预览，单次 y/n 确认），完成后删除标记文件
+
+---
+
+## Step 1：选择 Skill
+
+通过 Bash 工具扫描已安装的 Skill：
+
+```bash
+for f in skills/*/skill.yaml; do
+  name=$(basename $(dirname "$f"))
+  [[ "$name" == _* ]] && continue
+  version=$(grep '^version:' "$f" 2>/dev/null | awk '{print $2}')
+  desc=$(grep '^description:' "$f" 2>/dev/null | cut -d: -f2- | xargs)
+  echo "$name|$version|$desc"
+done
+```
+
+**@Skill 路由检测（优先于菜单，跳过选择步骤）：**
+
+在进入菜单逻辑前，检查激活消息是否包含 `@{word}` 模式：
+
+**特殊指令：**
+- `@?` 或 `@list`：列出所有可用 Skill，不激活，停止等待。
+
+**即时纠正检测（最高优先级）：**
+消息同时含 `@{name}` 和纠正信号词（纠正/漏掉/补充/修正/应该/下次/记住/wrong/missed）时：
+- 不执行材料分析
+- 读取 `skills/_kernel/distillation.md` 的 Mini-蒸馏协议章节
+- 对指定 Skill 执行即时纠正写入
+- 完成后恢复等待
+
+**群聊路由（多 Skill）：**
+消息含一个或多个 `@{name}` 且无纠正信号词时：
+
+```bash
+# 检测 --parallel 标志
+PARALLEL=false
+echo "$MESSAGE" | grep -qE '\-\-parallel\b' && PARALLEL=true
+
+# 提取所有 @token，展开 @all（忽略 --parallel 本身）
+SKILLS=()
+for token in $MESSAGE_TOKENS; do
+  [[ "$token" =~ ^@(.+)$ ]] || continue
+  name="${BASH_REMATCH[1]}"
+  [[ "$name" == "all" || "$name" == "?" || "$name" == "list" ]] && continue
+  [[ -f "skills/$name/skill.yaml" ]] && SKILLS+=("$name") || echo "❌ @$name 不存在"
+done
+if echo "$MESSAGE" | grep -q '@all'; then
+  for f in skills/*/skill.yaml; do
+    n=$(basename $(dirname "$f")); [[ "$n" == _* ]] && continue; SKILLS+=("$n")
+  done
+fi
+```
+
+- **SKILLS 为空：报错并列出可用 Skill，停止。
+- **SKILLS 有一个**：单 Skill 模式，`{skill}` 设为该名称，继续 Step 2。
+- **SKILLS 有多个**：进入群聊模式，将 `{skills}` 设为列表、`{parallel}` 设为 `$PARALLEL`，继续 Step 2。
+
+材料 = 去除所有 `@token` 和 `--parallel` 后剩余文本；材料非空则 Step 4 直接执行分析。
+
+---
+
+根据扫描结果执行不同分支（仅在未触发 @Skill 路由时执行）：
+
+**未安装任何 Skill：**
+```
+❌ 尚未安装任何 Skill。
+
+安装方式：
+  telos install req-mining
+  telos available        # 查看所有可用 Skill
+  /add-skill               # 快速创建新 Skill
+```
+停止，等待用户操作。
+
+**只有一个 Skill：**
+直接激活，输出 `✓ 使用 Skill：{name} v{version}`，将 `{skill}` 设为该 Skill 名称，继续 Step 2。
+
+**多个 Skill：**
+输出选择菜单：
+```
+━━━ 选择 Skill ━━━
+
+  1. {name1}   v{ver}  —  {desc}
+  2. {name2}   v{ver}  —  {desc}
+  ...
+
+输入编号激活（或 @{name} 单选 / @a @b 群聊 / @all 全开 / 0 退出）：
+```
+等待用户输入，将选择结果设为 `{skill}` 或 `{skills}`，继续 Step 2。
+
+---
+
+## Step 2：加载运行时上下文
+
+**单 Skill 模式**（`{skill}` 为单一名称）：
+
+按顺序读取：
+1. `skills/{skill}/memory/failure-patterns.md`（若存在则加载，常驻知识）
+2. `skills/{skill}/skill.yaml`
+3. `skills/{skill}/domain.md`
+
+**群聊模式**（`{skills}` 为列表）：
+
+对 `{skills}` 中每个 Skill，并行加载：
+1. `skills/{name}/memory/failure-patterns.md`
+2. `skills/{name}/skill.yaml`
+3. `skills/{name}/domain.md`
+
+输出加载确认：
+```
+✓ 已加载 Skills：
+  • @{name1} v{ver} — {desc}
+  • @{name2} v{ver} — {desc}
+```
+
+---
+
+## Step 3：显示飞轮状态
+
+**单 Skill 模式：**
+```
+━━━ Telos 就绪 ━━━
+Skill：{skill} v{version}
+待蒸馏项目：{N} 个
+活跃项目：
+  • {project_id} — 阶段：{状态} | 假设：{N} 项
+
+提供材料开始 Ring 1 分析：
+  • 直接粘贴文本 / 文件路径 / URL
+━━━━━━━━━━━━━━━━━━━━
+```
+
+**群聊模式：**
+```
+━━━ 群聊开启 ━━━
+Skills：@{name1} @{name2} ...
+模式：{隔离顺序（默认）| 真并行（--parallel）}
+项目：{project_id}
+待蒸馏项目：{N} 个
+
+提供材料，所有 Skill 将独立分析后汇总：
+  • 直接粘贴文本 / 文件路径 / URL
+  • 追加 --parallel 开启真并行子任务
+  • @{name} 纠正内容  → 即时更新该 Skill 的 memory / domain
+━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## Step 4：分析材料
+
+**单 Skill 模式：**
+用户提供材料后，执行 `skills/{skill}/domain.md` 中的分析协议，输出分析结果。
+
+---
+
+**群聊模式 · 伪并行（默认，`{parallel}` = false）：**
+
+核心原则：**上下文隔离**——每个 Skill 分析时只看材料，不看其他 Skill 的输出。
+
+执行步骤：
+1. 在开始任何分析前，为所有 Skill 读取并缓存：
+   - `skills/{name}/memory/failure-patterns.md`
+   - `skills/{name}/domain.md`
+2. 逐个切换视角分析：
+   - 激活 `@{name}` 视角，加载其 domain.md + memory
+   - **明确遮蔽**：此时不参考任何已产生的其他 Skill 输出
+   - 完成分析，将结果缓存到 `{output_name}`
+   - 切换到下一个 Skill，重复
+3. 所有 Skill 分析完毕后，**一次性并排展示**所有缓存结果：
+
+```
+[@{name1}]
+  {分析结论}
+  假设：…  信息缺口：…
+
+[@{name2}]
+  {分析结论}
+  假设：…  信息缺口：…
+```
+
+4. 展示综合视图（见下）。
+
+---
+
+**群聊模式 · 真并行（`{parallel}` = true，用户追加 `--parallel`）：**
+
+核心原则：**实例隔离**——通过 Agent 工具派生独立子 Agent，各自在完全独立的上下文中运行，互不可见。
+
+执行步骤：
+
+**4-P1. 为每个 Skill 构建自包含 prompt（派生前必须完成）**
+
+为每个 `{name}` 读取文件并组装：
+```
+[子任务 prompt for @{name}]
+
+你是 [{name}] Skill，专注领域：{description}。
+任务：独立分析下方材料，只从你的专业视角出发，不参考任何其他视角。
+
+## 你的分析协议
+{skills/{name}/domain.md 的完整内容}
+
+## 你的经验记忆
+{skills/{name}/memory/failure-patterns.md 的内容，若不存在则省略}
+
+## 待分析材料
+{用户提供的材料}
+
+## 输出格式要求
+以 [@{name}] 开头，按你的 domain.md 协议输出分析结论。
+最后注明：假设清单、信息缺口。
+不得引用或预测其他 Skill 的观点。
+```
+
+**4-P2. 并发派生所有子 Agent**
+
+通过 Agent 工具，对每个 `{name}` 发起调用（`run_in_background: true`）：
+```
+Agent(
+  description: "@{name} 独立分析",
+  prompt: {上方构建的自包含 prompt},
+  run_in_background: true
+)
+```
+所有派生调用在同一消息中发出，实现真正并发。
+
+**4-P3. 等待并收集结果**
+
+等待所有子 Agent 返回（后台任务完成时自动通知）。
+收集每个子 Agent 的输出文本，按 Agent 名称索引存入 `{results}`。
+
+**4-P4. 并排展示**
+
+将所有结果按 `[@{name}]` 标头格式并排输出：
+```
+[@{name1}]  ⚡ 真并行
+  {子 Agent 返回的分析结论}
+
+[@{name2}]  ⚡ 真并行
+  {子 Agent 返回的分析结论}
+```
+
+---
+
+**综合视图（两种模式共用）：**
+
+```
+━━━ 综合视图 ━━━
+模式：{隔离顺序 | ⚡ 真并行}  ·  Skills: @{a} @{b} ...
+
+共识：{各 Skill 一致认定的结论}
+分歧：
+  • @{name1} 认为… ↔ @{name2} 认为…
+建议下一步：{面向用户的行动建议}
+
+状态：━━━ [Ring 1] | Skills: @{a} @{b} | 项目: {id} | 假设: N项 ━━━
+```
+
+---
+
+**群聊中的纠正：**
+用户输入 `@{name} 纠正内容` 时，执行即时 Mini-蒸馏（见 `skills/_kernel/distillation.md`），
+不中断群聊，纠正完成后继续等待下一轮材料。
+
+---
+
+**别名：** 用户输入 `tos`、`/tos`、`telos`、`开始 telos`、`开启 telos` 时，等同于运行本命令。
+
+**@Skill 会话中路由：** 飞轮已激活后，用户任意时刻输入 `@{skill} ...` 触发 Step 1 的 @Skill 快速路由逻辑，切换当前 Skill 并处理后续材料，无需重新 `tos`。
+
+**自然语言激活（无感模式）：**
+用户在任意时刻说 "启动 telos"、"开始分析"、"帮我看看这份文档"、"专家会诊" 等暗号，也等同于运行本命令。
+
+**暗号提示：**
+若 `codewords.hint_on_start: true`，首次进入会话时输出：
+```
+━━━ Telos 已就绪 ━━━
+你可以像日常聊天一样使用我。
+几个常用暗号：
+  • 说"记下来" — 保存刚才聊的技巧
+  • 说"看看家底" — 查看你的技能库
+  • 说"暗号大全" — 查看所有可用暗号
+随时说"对暗号"查看完整列表。
+━━━━━━━━━━━━━━━━━━━━
+```