使用命令行工具

更新时间:
复制为 MD 格式

通过acr-skillORAS命令行工具,可以实现基于ACR企业版实例的Skill推送和拉取操作。

使用acr-skill工具

acr-skill是专为Skill管理设计的命令行工具,提供Skill的完整生命周期管理能力,包括发布、安装、更新、列表查看、验证等功能,例如:

下方仅为部分示例,详细使用方法请参见命令行工具 acr-skill
  • 发布Skill:将本地Skill目录打包为OCI 制品,并发布到ACR 企业版实例。

    acr-skill publish <registry>/skills/my-skill:1.0.0 \
      --dir ./my-skill --username <USERNAME> --password <PASSWORD>
  • 安装Skill:从ACR企业版实例拉取Skill制品并安装到本地目录。

    acr-skill install my-skill \
      --namespace skills \
      --version 1.0.0 --username <USERNAME> --password <PASSWORD>
  • 查看Skill:显示已安装的Skill列表。

    # 列出当前目录的 Skill
    acr-skill list
    
    # 列出指定目录的 Skill
    acr-skill list --directory ./my-skills
    
    # JSON 格式输出
    acr-skill list --format json

使用ORAS工具

ORAS是一个开源的命令行工具,用于向兼容OCIRegistry推送和拉取任意类型的制品。如果不希望安装acr-skill工具,可以使用ORAS完成基本的Skill推送和拉取操作。

请参见官方文档安装ORAS工具。

推送 Skill

  1. 打包Skill目录:

    # 进入 Skill 目录的上级目录
    cd /path/to/parent
    
    # 将 Skill 目录打包为 tar.gz(排除 .git)
    tar --exclude='.git' -czf my-skill.tar.gz -C my-skill .
  2. 创建内容为空的配置文件:

    echo '{}' > config.json
  3. 使用oras push上传:

    oras push <registry>/skills/my-skill:1.0.0 \
      --artifact-type application/vnd.agent.skill.v1+json \
      --config config.json:application/vnd.oci.empty.v1+json \
      my-skill.tar.gz:application/vnd.agent.skill.content.v1.tar+gzip \
      --annotation "org.agent.skill.name=my-skill" \
      --annotation "org.agent.skill.version=1.0.0" \
      --annotation "org.agent.skill.description=我的自定义Skill"
  4. 清理临时文件:

    rm -f my-skill.tar.gz config.json

拉取Skill

  1. 创建专用目录:

    mkdir -p ./downloaded-skill
  2. 下载Skill制品:

    oras pull <registry>/skills/my-skill:1.0.0 \
      -o ./downloaded-skill
  3. 如果下载的是tar.gz文件,则需解压:

    cd ./downloaded-skill
    tar -xzf *.tar.gz
    rm -f *.tar.gz