Skill Trigger V2

# 🔷 Skill Trigger V2 🔷

**Powered by halfmoon82** 🔷

智能技能触发系统 - 快速匹配用户意图到对应技能。

> **Core Algorithm**: Powered by [Halfmoon82](https://github.com/halfmoon82) — 统一阈值 + 优先级仲裁架构设计

## 触发条件

- 用户自然语言输入
- 技能索引已初始化
- 语义路由系统可用

## 依赖要求

| 技能 | 版本约束 | 状态检测命令 |
|------|---------|-------------|
| `skill-quick-index` | `>=1.0.0` | `skill-quick-index --version` |
| `semantic-router` | `>=7.7.2` | `semantic-router --version` |

## 安装向导

### Step 1: 前置检查

```bash
# 检查依赖是否已安装
python3 ~/.openclaw/workspace/skills/skill-trigger-v2/setup/wizard.py check
```

### Step 2: 依赖安装

若依赖缺失，向导会提示：

```
❌ 缺少依赖: skill-quick-index (>=1.0.0)
   请运行: clawhub install skill-quick-index@latest

❌ 缺少依赖: semantic-router (>=2.0.0)  
   请运行: clawhub install semantic-router@latest
```

### Step 3: 版本验证

```bash
# 验证依赖版本兼容性
python3 ~/.openclaw/workspace/skills/skill-trigger-v2/setup/wizard.py verify
```

### Step 4: 初始化配置

```bash
# 创建默认配置
python3 ~/.openclaw/workspace/skills/skill-trigger-v2/setup/wizard.py init
```

## 使用方法

### 基础调用

```python
from skill_trigger_v2 import SkillTrigger

trigger = SkillTrigger()
result = trigger.match("帮我安装安全技能")

if result.matched:
    print(f"命中: {result.skill_id}")
    print(f"置信度: {result.confidence}")
```

### 集成到代理

在 `SOUL.md` 的消息处理循环中加入：

```python
# 1. 先尝试技能触发
from skill_trigger_v2 import fit_gate, generate_declaration

result = fit_gate(user_input)
if result.matched:
    declaration = generate_declaration(result)
    # 追加声明到回复第一行
    return declaration + "\n\n" + skill_response

# 2. 未命中则回退到语义路由
# ... semantic router logic
```

## 配置项

`~/.openclaw/workspace/.lib/skill_trigger_config.json`:

```json
{
  "version": "2.0.0",
  "threshold": {
    "coverage": 0.5,
    "description": "统一覆盖率阈值，所有技能一视同仁"
  },
  "arbitration": {
    "e...

# Skill Trigger V2

> **Powered by [Halfmoon82](https://github.com/halfmoon82)** — 让每一次对话，都能准确找到它需要的技能。

---

## 这是什么？

Skill Trigger V2 是一个**智能技能触发器**。它像一位经验丰富的管家，听你说话，然后精准地判断你需要哪个技能来帮忙。

不同于传统的关键词匹配，它采用**统一阈值 + 优先级仲裁**的设计，让 L0 的安全技能和 L3 的小众工具站在同一起跑线上公平竞争。

---

## 核心设计理念

### 🎯 一视同仁的门槛

无论技能是 L0（系统级）还是 L3（扩展级），只要你的话语**50% 覆盖了它的触发词组**，它就进入候选池。没有偏见，没有特权。

### ⚖️ 聪明的仲裁机制

进入候选池后，四个层次的仲裁会选出最佳匹配：

1. **独占词优先** — 如果某技能有独特的"指纹词"（如"安全审查"），它直接胜出
2. **加权分数** — 覆盖率 × 等级权重，L0 技能权重稍高（1.2），但不高到垄断
3. **置信度差距** — 如果最佳候选明显优于第二名（差距≥0.2），直接确定
4. **权重决胜** — 实在接近时，原等级作为最后的平局打破者

### 🔗 非连续理解

你说"我想**安全**地把这个**技能****安装**一下"，即使三个关键词分散在句中，它依然能识别这是 `skill-safe-install`。

---

## 使用之前：你需要准备好这些

Skill Trigger V2 **不是孤军奋战**的。它依赖两个基础技能，就像一座房子需要地基：

### 📚 依赖一：Skill Index（技能索引）

**版本要求**: `>= 1.0.0`

这是技能的"电话簿"。它维护着所有可用技能的元数据、触发词、等级信息。没有它，Trigger 不知道有哪些技能可以匹配。

**如何准备**:
```bash
# 确认 skill_index.json 存在且包含版本信息
cat ~/.openclaw/workspace/.lib/skill_index.json | grep '"version"'
```

如果不存在，你需要先安装或初始化技能索引系统。

---

### 🧭 依赖二：Semantic Router（语义路由）

**版本要求**: `>= 2.0.0`

这是技能的"后备大脑"。当 Trigger 无法匹配任何技能（低于 50% 阈值）时，对话会优雅地回退到语义路由，由它继续处理。

**如何准备**:
```bash
# 确认 pools.json 存在且包含版本信息
cat ~/.openclaw/workspace/.lib/pools.json | grep '"version"'
```

如果不存在，你需要先安装或初始化语义路由系统。

---

### ⚠️ 版本兼容性说明

我们采用**严格的向后兼容策略**（`>=` 约束）：

| 场景 | 结果 | 说明 |
|------|------|------|
| Skill In...