技能更新管理器

任务目标

• 本 Skill 用于：统一管理所有已安装技能的注册信息与版本跟踪
• 能力包含：技能注册、版本记录、自动检查更新、更新配置管理
• 触发条件：安装新技能前、需要检查技能更新时、首次加载本技能

前置准备

依赖说明

scripts脚本所需的依赖包及版本：

requests==2.31.0
beautifulsoup4==4.12.2
packaging==23.2
PyYAML==6.0.1

配置文件初始化

首次使用本技能时，需要将已安装的技能注册到skills-update-manager，并需要在工作目录下 MEMORY.md文件添加以下：

# 技能更新管理器配置

## 更新设置
- 启用更新检查：是/否
- 上次检查时间：YYYY-MM-DD HH:MM:SS

## 使用说明
1. 每次安装技能前优先加载 skills-update-manager
2. 更新开启时，启动技能前需加载本管理器检查更新
3. 更新关闭时，跳过更新检查

操作步骤

1. 注册新技能

核心流程：智能体自动从技能文件中提取元数据，无需用户提供详细信息。

步骤1：提取技能元数据

当用户安装新技能时，智能体需要从技能文件中提取以下信息：

方式A：从 .skill 或者.zip文件提取

1. 解压 .skill 文件（ZIP格式）
2. 读取 SKILL.md 文件
3. 从 YAML 前言区提取：
   • name：技能名称
   • version：版本号（如果存在）
4. 从文件路径或内容推断更新地址

方式B：从已解压的技能目录提取

1. 读取 SKILL.md 文件
2. 从 YAML 前言区提取 name 字段

调用脚本：scripts/skill_registry.py --action extract --skill-path <路径>

输出示例：

{
  "success": true,
  "metadata": {
    "name": "pdf-processor",
    "version": "1.0.0",
    "source": null,
    "update_url": null
  }
}

步骤2：识别来源和更新地址

智能体根据以下信息推断来源类型和更新地址：

判断规则：

• 如果用户提供 GitHub 仓库地址 → 来源：github
• 如果用户提供 ClawHub 页面链接 → 来源：clawhub
• 如果用户未提供 → 询问用户技能来源

典型场景：

用户："安装这个技能：https://github.com/user/skill-name"
智能体：识别来源为 github，提取仓库地址

用户："安装 xxx.skill 文件"
智能体：提取技能名称后询问："这个技能的来源是什么？(GitHub/ClawHub/其他)"

步骤3：注册技能

调用脚本：scripts/skill_registry.py --action register

必需参数：

• --name：技能名称（从 SKILL.md 提取）

可选参数（智能体推断或询问用户）：

• --version：当前版本号（从 SKILL.md 提取，默认 "1.0.0"）
• --source：来源类型（github/clawhub，默认 "github"）
• --update-url：更新地址（根据来源推断或询问用户）

执行示例：

# 完整参数（智能体已提取所有信息）
python scripts/skill_registry.py \
  --action register \
  --name "pdf-processor" \
  --version "1.0.0" \
  --source "github" \
  --update-url "https://github.com/user/pdf-processor"

# 最小参数（仅需名称，其余使用默认值）
python scripts/skill_registry.py \
  --action register \
  --name "pdf-processor"

智能体职责：

• 自动从技能文件中提取名称和版本号
• 根据用户提供的信息推断来源和更新地址
• 信息不完整时主动询问用户
• 确保所有必需字段已填充后再调用注册

2. 检查技能更新

根据 MEMORY.md 中的配置，决定是否检查更新：

调用脚本：scripts/skill_registry.py --action check_updates

执行逻辑：

1. 读取 MEMORY.md 配置，判断更新检查是否启用
2. 如果启用，遍历所有已注册技能
3. 根据技能来源类型调用对应的版本检查逻辑：
   • GitHub：访问 https://api.github.com/repos/{owner}/{repo}/releases/latest
   • ClawHub：访问技能页面，解析 "Current version" 字段
4. 对比本地版本与远程版本
5. 返回有更新的技能列表

输出格式：

{
  "has_updates": true,
  "updates": [
    {
      "name": "example-skill",
      "current_version": "v1.0.0",
      "latest_version": "v1.2.0",
      "source": "github",
      "update_url": "https://github.com/user/example-skill"
    }
  ]
}

智能体职责：

• 解析检查结果，向用户推送更新通知
• 询问用户是否执行更新操作
• 如果用户确认更新，使用 git clone 或下载方式获取新版本
• 更新本地技能记录

3. 查看已注册技能

列出所有已安装技能的详细信息：

调用脚本：scripts/skill_registry.py --action list

输出内容：

• 编号
• 名称
• 版本
• 来源
• 更新地址
• 是否可更新
• 更新状态

4. 更新配置

修改 MEMORY.md 中的更新设置：

调用脚本：scripts/skill_registry.py --action update_config