文档中心

火山方舟

Skills

导入 GitHub 技能

POST https://ark.cn-beijing.volces.com/api/v3/skills/github/import

导入 GitHub 技能前，先调用扫描 GitHub 技能接口，获取可导入的技能及本次扫描对应的仓库信息。

服务端将所选技能与当前已有技能对比后，分别处理：

所选技能尚未导入时，服务端创建技能。

所选技能已导入，但本次扫描的提交与最新版本对应的提交不同时，服务端创建新版本。

所选技能已导入，且两次提交相同时，服务端跳过该项。

请求成功不表示每项都导入成功。调用后，检查 items[].status 获取每项导入结果。

鉴权

本接口支持鉴权方式如下，详情请参见 Base URL 及鉴权。

API Key 鉴权，请在 API Key 管理页面，获取长效 API Key。

请求参数

Body 参数

repo object 必选 | 仓库信息

selected object[] 必选 | 待导入技能

响应参数

items object[] | 导入结果

默认

Request

curl -sS --fail-with-body "https://ark.cn-beijing.volces.com/api/v3/skills/github/import" \
  -H "Authorization: Bearer $ARK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "repo": {
      "owner": "anthropics",
      "name": "skills",
      "commit_sha": "<COMMIT_SHA>",
      "html_url": "https://github.com/anthropics/skills"
    },
    "selected": [
      {
        "path": "skills/pdf",
        "protection_enabled": true
      }
    ]
  }'

Response

{
  "items": [
    {
      "path": "skills/pdf",
      "status": "ok",
      "skill_id": "skill-20260922102030-a1b2c"
    }
  ]
}

最近更新时间：2026.10.23 21:12:27

这个页面对您有帮助吗？

有用

无用