@vima_tech/telos 1.4.0

package/README.md

@@ -0,0 +1,179 @@
+# Telos
+
+**Towards who you become.**
+
+Your conversations grow into reusable skills. Telos turns what you learn into what you carry forward — across every domain, every session, towards the person you're becoming.
+
+Runs inside Claude Code — no server, no setup.
+
+[中文文档 →](README.zh.md)
+
+---
+
+## The Problem
+
+Current AI memory knows who you are. It doesn't know what you've learned.
+
+You figure out the trick to braising meat. You nail a negotiation framework. You debug a subtle async race condition. Next session: gone. The AI starts cold, and you start explaining again.
+
+- **Declarative memory** (preferences, background) — every major AI has this.
+- **Procedural memory** (how to do things) — nobody is building this.
+
+The gap: you have better conversations every day, but you never get permanently better at anything.
+
+---
+
+## What Telos Does
+
+**Skills Library** — Every conversation that teaches you something can be distilled into a skill file. Next time the topic comes up, Telos loads what you already know and picks up where you left off — any domain, not just coding.
+
+```
+Session 1: you work out braising technique with Claude
+→ /skill save   →   skills/cooking/braising.md
+
+Session 2: "how do I braise short ribs?"
+→ Telos silently loads braising.md
+→ Claude starts from your existing knowledge, not from zero
+```
+
+**Multi-expert Deliberation** — Use `@skill` to summon domain-expert protocols into the same session. Each analyzes your material independently, then Telos synthesizes: consensus, divergence, recommended next step.
+
+```
+tos @req-mining @code-review review this spec
+req-mining  →  5 requirements · gap: budget undefined
+code-review →  requirement 3 has tech risk · prototype first
+Synthesis   →  consensus on scope · diverge on timeline · prototype first
+```
+
+**Flywheel** — Expert protocols self-improve from execution feedback. Instant correction: `@req-mining you missed priority ranking` — written to memory immediately, no log accumulation needed.
+
+---
+
+## Highlights
+
+| | |
+|---|---|
+| **Skill growth** | Conversations → structured reusable skills, auto-loaded next session |
+| **Any domain** | Cooking, negotiation, writing, coding — not limited to programming |
+| **`@skill` routing** | `tos @req-mining @code-review spec.md` — one line, multiple experts |
+| **Context isolation** | Each expert sees only your material, not others' answers — no groupthink |
+| **`--parallel` mode** | Real independent sub-agents concurrently, not role-playing |
+| **Instant correction** | `@skill you missed X` writes to memory immediately |
+| **Self-evolving** | Ring 3 distillation turns execution failures into permanent protocol improvements |
+| **Industry packs** | Domain knowledge auto-loaded by keyword (ERP, retail, trade…) |
+
+---
+
+## Install
+
+> Tip: paste either command below directly into Claude Code — Claude will run it for you.
+
+**New project:**
+
+```bash
+npm install -g @vima_tech/telos
+telos new my-project
+cd my-project && claude
+```
+
+**Embed into an existing project:**
+
+```bash
+curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | bash
+
+# Install with a specific skill package
+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.
+
+---
+
+## Usage
+
+```bash
+# Grow your skills
+/skill save                        # distill current conversation into a skill
+/skill save cooking/braising       # save with specific domain/name
+/skill list                        # see what you know
+/skill load negotiation            # manually load a domain into context
+
+# Multi-expert deliberation
+tos @req-mining review this PRD...           # single expert
+tos @req-mining @code-review review this...  # group deliberation, isolated
+tos @req-mining @code-review ... --parallel  # true parallel sub-agents
+tos @all review this...                      # every installed skill
+
+# Corrections (write to memory instantly)
+@req-mining you missed priority ranking
+@?                                           # list available skills
+```
+
+---
+
+## How Skills Work
+
+Two kinds of skills live in `skills/` — distinguished by whether they have a `skill.yaml`:
+
+**Protocol skills** (have `skill.yaml`) — structured analysis frameworks like `req-mining` or `code-review`. Installed from the registry, self-improving via the flywheel.
+
+**Knowledge skills** (no `skill.yaml`) — procedural knowledge extracted from your conversations. `cooking/braising`, `negotiation/salary`, `writing/technical`. Accumulated over time, loaded automatically by topic.
+
+```
+skills/
+  req-mining/       ← protocol skill (summon with @req-mining)
+    skill.yaml
+    domain.md
+  cooking/
+    braising.md     ← knowledge skill (auto-loads on cooking topics)
+  _index.md         ← topic-matching index for auto-loading
+```
+
+---
+
+## The Flywheel
+
+```
+Ring 1  @skill analyzes → assumptions flagged · gaps listed · synthesis view
+Ring 2  Execution tool implements → failures written to .telos-feedback.json
+Ring 3  ≥3 feedback items, or instant @skill correction
+          → distill → update protocol memory / domain
+          → skill is more accurate next session
+```
+
+One manual touchpoint: a single y/n on the distillation diff preview.
+
+---
+
+## Build Your Own Skill
+
+```bash
+/add-skill
+# guided: name · description · use case · trigger keywords
+# generates skills/{name}/ with tier: workspace
+
+./scripts/telos-install.sh publish {name}   # share via registry
+```
+
+---
+
+## Contributing
+
+- **New skills** — PR to `skills/your-skill-name/`
+- **Industry packs** — add to `skills/{name}/industry/`
+- **Kernel** — `scripts/` or `skills/_kernel/`
+
+---
+
+## License
+
+MIT
+
+
+<div align="center" style="background:#0b0d12; padding:24px 0; margin:0; border-radius:8px;">
+
+![Telos Poster](docs/Telos_Poster.png)
+
+**[📄 View Full Poster →](docs/Telos_Poster.html)**
+
+</div>

package/README.zh.md

@@ -0,0 +1,180 @@
+[English →](README.md)
+
+# Telos
+
+**走向你将成为的那个人。**
+*Towards who you become.*
+
+对话里学到的东西，不该下次就忘掉。Telos 把你每次对话的收获提炼为可复用的技能，持久留存，跨越每一个领域、每一次会话——走向那个更懂行、更有积累的你。
+
+运行在 Claude Code 内部——无需服务器，无需配置。
+
+---
+
+## 痛点
+
+现有 AI 记住你**是谁**。但不记得你**懂什么**。
+
+你学会了红烧肉的诀窍，摸透了谈判的节奏，调通了一个隐蔽的异步 bug——下次会话：全部清零。AI 重新从零开始，你重新从头解释。
+
+- **陈述性记忆**（偏好、背景）：所有主流 AI 都在做。
+- **程序性记忆**（怎么做事）：没有人在做。
+
+这个缺口就是：你每天的对话在进步，但你没有在任何领域真正变得更厉害。
+
+---
+
+## Telos 做什么
+
+**技能库** — 每次有收获的对话都可以提炼为技能文件。下次同类话题出现，Telos 静默加载你已有的知识，从你上次停下的地方继续——不限于编程，任何领域都可以。
+
+```
+第一次会话：和 Claude 研究红烧肉的技巧
+→ /skill save   →   skills/cooking/braising.md
+
+第二次会话："炖牛腩怎么做？"
+→ Telos 静默加载 braising.md
+→ Claude 从你已有的基础出发，不从零开始
+```
+
+**多专家分析** — 用 `@skill` 把领域专家协议召入同一会话，各自独立分析你的材料，Telos 输出综合视图：共识、分歧、下一步建议。
+
+```
+tos @req-mining @code-review 帮我看这份需求文档
+req-mining  →  识别到 5 个需求 · 信息缺口：预算范围未定义
+code-review →  需求 3 存在技术风险 · 建议先做原型再排期
+综合视图    →  范围上达成共识 · 时间线存在分歧 · 先做原型
+```
+
+**飞轮** — 专家协议从执行反馈中自动进化。即时纠正：`@req-mining 你漏掉了优先级排序` — 直接写入记忆，无需等待积累门槛。
+
+---
+
+## 亮点
+
+| | |
+|---|---|
+| **技能成长** | 对话 → 结构化可复用技能，下次会话自动加载 |
+| **不限领域** | 烹饪、谈判、写作、编程——技能库不只是给程序员用的 |
+| **`@skill` 路由** | `tos @req-mining @code-review 文档` — 一行命令，多位专家 |
+| **上下文隔离** | 每个专家只看你的材料，看不到其他专家的输出——杜绝群体思维 |
+| **`--parallel` 真并行** | 派生真正独立的子任务并发运行，不是角色扮演 |
+| **即时纠正** | `@skill 你漏掉了 X` 立即写入记忆，不需要积累日志 |
+| **自我进化** | Ring 3 蒸馏将执行失败转化为协议的永久改进 |
+| **行业包** | 关键词自动加载领域知识（ERP、零售、外贸……）|
+
+---
+
+## 安装
+
+> 提示：将下面的命令直接粘贴到 Claude Code 中，Claude 会帮你执行。
+
+**新建项目：**
+
+```bash
+npm install -g @vima_tech/telos
+telos new my-project
+cd my-project && claude
+```
+
+**嵌入现有项目：**
+
+```bash
+curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | bash
+
+# 指定安装特定 Skill 包
+curl -sSL https://raw.githubusercontent.com/renmengkai/telos/main/install.sh | bash -s req-mining
+```
+
+两种方式均包含 `skills/`、`scripts/`、`CLAUDE.md` 以及 `telos` / `tos` 命令。安装完成后，打开 Claude Code，输入 `tos` 即可启动。
+
+---
+
+## 使用方式
+
+```bash
+# 积累你的技能
+/skill save                         # 把当前对话提炼为技能
+/skill save cooking/braising        # 指定领域和名称
+/skill list                         # 查看你已掌握的技能
+/skill load negotiation             # 手动加载某领域到当前上下文
+
+# 多专家分析
+tos @req-mining 帮我看这份 PRD...              # 单专家分析
+tos @req-mining @code-review 帮我看这份...     # 群聊，隔离顺序（默认）
+tos @req-mining @code-review ... --parallel   # 真并行子任务
+tos @all 帮我看这份...                         # 激活所有已安装 Skill
+
+# 即时纠正（直接写入记忆）
+@req-mining 你漏掉了优先级排序
+@?                                            # 列出可用 Skill
+```
+
+---
+
+## 两类 Skill
+
+`skills/` 目录下共存两类技能，通过是否有 `skill.yaml` 区分：
+
+**协议 Skill**（有 `skill.yaml`）— 结构化分析框架，如 `req-mining`、`code-review`。从注册表安装，通过飞轮自我进化。
+
+**知识 Skill**（无 `skill.yaml`）— 从对话提炼的程序性知识，如 `cooking/braising`、`negotiation/salary`。随时间积累，按话题自动加载。
+
+```
+skills/
+  req-mining/       ← 协议 Skill（用 @req-mining 召唤）
+    skill.yaml
+    domain.md
+  cooking/
+    braising.md     ← 知识 Skill（烹饪话题时自动加载）
+  _index.md         ← 话题匹配索引
+```
+
+---
+
+## 飞轮三环
+
+```
+Ring 1  @skill 分析 → 标注假设 · 列出信息缺口 · 输出综合视图
+Ring 2  执行工具落地 → 失败写入 .telos-feedback.json
+Ring 3  ≥3 条反馈，或 @skill 即时纠正
+          → 蒸馏 → 更新协议记忆 / 分析协议
+          → 下次分析更准确
+```
+
+唯一需要人工操作的是蒸馏差异预览的一次 y/n 确认。
+
+---
+
+## 创建自己的 Skill
+
+```bash
+/add-skill
+# 引导填写：名称 · 描述 · 使用场景 · 触发词
+# 自动生成 skills/{name}/，tier: workspace
+
+./scripts/telos-install.sh publish {name}   # 稳定后发布到注册表
+```
+
+---
+
+## 开源贡献
+
+- **新 Skill** — PR 到 `skills/your-skill-name/`
+- **行业包** — 添加到 `skills/{name}/industry/`
+- **内核改进** — 修改 `scripts/` 或 `skills/_kernel/`
+
+---
+
+## License
+
+MIT
+
+---
+<div align="center" style="background:#0b0d12; padding:24px 0; margin:0; border-radius:8px;">
+
+![Telos Poster](docs/Telos_Poster.png)
+
+**[📄 View Full Poster →](docs/Telos_Poster.html)**
+
+</div>