Skill管理

命令格式

./devkitai skills [-h] [list | update | clean]

参数说明

使用示例

• 下载更新Skills。

  ./devkitai skills update

  返回信息如下：

  准备更新所有配置的skills...
  当前配置的skills存放目录/home/skills不存在，努力创建中。
  当前配置的skills存放目录/home/skills创建成功。
  准备更新Skill DevkitAI
  开始检测skillDevkitAI下载地址的网络连通性，请耐心等待。
  网络连接成功，开始下载Skill: DevkitAI
  100%[======================================================================]    0.81M   3.9MB/s eta  0m 00s
  解压进度 [==================================================] 301/301
  DevkitAI skill更新完成
  更新完成: 1/1 个 skills 成功
    [OK] DevkitAI (1.0.0)

  

  • 文档向量入库时间依赖词嵌入模型能力性能，模型能力较弱时可能会花费较长时间，请耐心等待几秒到几十分钟。
  • DevKit AI提供了默认的Skills配置，若有需要可以在工具目录“config/config.yaml”文件中自定义增加需要下载的Skills。

  配置示例如下：

  remote_skills:
      # embedding_model: "bge-m3:latest"  # skill embedding model
    load_child_skills: false    # true: 加载所有子 skill；false: 只加载顶层 skill
    candidate_k: 20    # 两路统一召回条数（正整数）
    weight_vector: 0.7    # 向量检索权重（0-1）
    similarity_threshold: 0.45   # 意图召回相似度阈值（0-1），阈值越高，意图识别越精确
    skills:
    - name: DevkitAI
      version: "1.0.0"
      url: "https://raw.gitcode.com/openeuler/kunpeng-devkit/archive/refs/heads/master.zip"
      checksum: ""      # 可留空，校验会跳过
      channel: api      # api: http方式下载/git： git clone方式下载/local：加载本地文件目录
      enable: true
      force_update: false      # 是否强制下载（忽略版本检测）
      local_filename: "DevkitAI.zip"      # 可选：指定下载文件名，不填则从URL自动解析，local方式不需要设置
      format: "auto"      # auto/tar.gz/zip/file/directory，如果选择auto且无法辨识具体文件包结构时，默认为directory

  表2 remote_skills全局配置

  参数	默认值	参数说明
  embedding_model	-	词嵌入模型名称，用于对skills进行向量化和检索。
  load_child_skills	True	是否加载子skills： true：开启。 false：关闭。
  candidate_k	20	检索候选数量（最小值1）。
  weight_vector	0.7	向量权重（0.0 ~ 1.0）。
  similarity_threshold	0.45	相似度阈值（0.0 ~ 1.0）。
  skills	-	Skills配置列表(具体配置请参见表3 单个Skill配置)。

  表3 单个Skill配置

  参数	参数选项	参数说明
  name	-	Skill名称。
  version	-	Skill版本号。默认 "1.0.0"。
  url	-	下载Skill的URL地址。 说明： 当channel设置为local时（即本地下载），url填写本地Skill目录路径：“/path/to/Skill-dir”（本地Skill放置目录，请根据实际进行替换）。
  checksum	-	文件校验和（用于验证下载完整性）。
  auth_token	-	认证Token（用于私有仓库访问）。
  file_checksums	-	多个文件的校验和映射。
  channel	api/git/local	下载渠道：api（API下载）、git（Git克隆）、local（本地）。
  enable	true/false	是否启用该Skill： true：开启。 false：关闭。
  force_update	true/false	是否启用强制更新。 true：开启。 false：关闭。
  local_filename	-	指定下载本地文件名，不填则从URL自动解析，local方式不需要设置。
  format	"auto"/"tar.gz"/"zip"/"file"/"directory"	下载文件格式，默认为"auto"。

• 列出已下载的Skills。

  ./devkitai skills list

  返回信息如下：

  已下载的 skills（共 1 个）：
  
  
  名称                             版本              下载时间                
  -----------------------------------------------------------------
  DevkitAI                       1.0.0           2026-08-18 12:01:16

  

  DevKit AI支持本地模式直接加载Skills：直接将本地Skill文档放到“/home/skills”目录下，该方式无需执行./devkitai skills update，且支持扫描二级目录Skill加载多个skill，新开对话即可直接加载。

• 清理本地缓存Skills。

  ./devkitai skills clean

  返回信息如下：

  准备skill清理前环境检查...
  即将删除/home/skills目录下skill相关的所有文件
  请输入Y或N确认清理? (Y/y:清理， N/n：不清理): y
  清理完成