# skill-router

**Repository Path**: S_Yang/skill-router

## Basic Information

- **Project Name**: skill-router
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-17
- **Last Updated**: 2026-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# skill-router

技能路由中心，负责从 Nacos Skill Registry 发现并按需加载技能。

## 功能概述

该技能作为 AI Agent 的技能路由中心，每次对话必须通过该技能路由到正确的技能。工作流程如下：

1. **获取技能目录** - 从 Nacos Skill Registry 获取可用技能列表
2. **匹配技能** - 根据用户意图选择最匹配的技能
3. **检查技能版本** - 对比本地与远程版本，判断是否需要更新
4. **安装技能** - 仅在需要时下载并安装技能
5. **执行技能** - 加载目标技能并按其规则执行

## 项目结构

```
skill-router/
├── SKILL.md                      # 技能定义文件（执行协议）
├── scripts/                      # 核心脚本目录
│   ├── fetch_skill_catalog.py    # 获取技能目录
│   ├── check_skill_version.py    # 检查技能版本
│   ├── install_skill.py          # 安装/更新技能
│   ├── skills-lock.json          # 已安装技能锁定文件
│   └── skills-cli/               # 内置 skills CLI 工具
│       ├── bin/cli.mjs           # CLI 入口
│       └── dist/                 # 编译输出
└── README.md                     # 本文件
```

## 核心脚本说明

### fetch_skill_catalog.py
从 Nacos Skill Registry 获取完整的技能目录列表。

```bash
python scripts/fetch_skill_catalog.py
```

**输出格式：**
```json
{
  "skills": [
    {
      "skillName": "nacos-test",
      "description": "用于验证 Nacos 服务注册与发现的最小化技能",
      "type": "ai",
      "version": "1.0.0",
      "tags": ["test", "nacos"],
      "enabled": true,
      "labels": {...}
    }
  ],
  "total": 1
}
```

### check_skill_version.py
检查指定技能的本地版本是否需要更新。

```bash
python scripts/check_skill_version.py <skill_name> [--label <label>] [--namespace <namespace>]
```

**输出格式：**
```json
// 需要更新
{
  "needsUpdate": true,
  "reason": "version_mismatch",
  "skillName": "nacos-test",
  "localVersion": "1.0.0",
  "remoteVersion": "1.1.0"
}

// 无需更新
{
  "needsUpdate": false,
  "skillName": "nacos-test",
  "version": "1.0.0"
}
```

### install_skill.py
从 Nacos 下载并安装指定技能。

```bash
python scripts/install_skill.py <skill_name> [--version <version>] [--label <label>] [--namespace <namespace>]
```

**安装流程：**
1. 从 Nacos 下载技能 ZIP 包
2. 解压到临时目录
3. 查找技能根目录（包含 SKILL.md）
4. 写入 manifest 文件记录版本信息
5. 使用 skills CLI 完成安装
6. 清理临时文件

## Nacos 配置

脚本默认连接本地 Nacos 服务：

| 配置项 | 默认值 |
|--------|--------|
| Server 地址 | `127.0.0.1:8848` |
| Console 地址 | `127.0.0.1:8080` |
| 用户名 | `nacos` |
| 密码 | `nacos` |

## 技能安装路径

技能安装在以下目录结构中：

```
skills/                          # 技能根目录
├── skill-router/               # 当前技能
│   ├── scripts/
│   └── manifest/
│       └── manifest.json
└── {skill_name}/                # 其他已安装技能
    ├── SKILL.md
    └── manifest/
        └── manifest.json
```

## 依赖要求

- Python 3.7+
- Node.js（用于运行 skills CLI）

## 版本信息

- **当前版本**: 1.1.0
- **标签**: catalog, router, skill-discovery