概述

按名称读取一个已安装 Skill，可按 L0/L1/L2 语义层级选择返回内容，也可返回文件清单和来源元数据。未指定 target_uri 时，接口先查当前用户私有 Skill；未找到再查账户共享 Skill。

请求接口

URI	`/api/v1/skills/{skill_name}`
请求方法	GET
认证	`Authorization: Bearer {API_KEY}`

请求参数

参数	位置	类型	必选	默认值	说明
`skill_name`	Path	string	是	—	Skill 名称，必须符合 1～64 位 ASCII 字母、数字、下划线或连字符规则。
`target_uri`	Query	string	否	null	指定 Skill 根，用于在用户私有和账户共享作用域存在同名 Skill 时消歧。
`include_content`	Query	bool / null	否	null	是否返回 SKILL.md 正文。level 未指定时，null 与 true 都返回正文；false 不返回正文。
`include_files`	Query	bool	否	true	是否递归返回 Skill 文件清单。
`include_source`	Query	bool	否	false	是否返回来源追踪元数据。
`level`	Query	integer	否	null	限定语义层级：0 返回 abstract，1 返回 overview，2 返回 content。只允许 0、1、2。

level 与 include_content 的组合。level=0/1 时可以再传 include_content=true 追加正文；level=2 总会返回正文，即使显式传 include_content=false。level 未指定时默认返回 abstract、overview 和 content。

响应消息

字段	类型	说明
`result.type`	string	固定为 `skill`。
`result.name`	string	Skill 名称。
`result.uri`	string	Skill 目录 URI。
`result.root_uri`	string	与 uri 相同。
`result.skill_md_uri`	string	SKILL.md URI。
`result.description`	string	Skill 描述。
`result.tags`	array	标签列表。
`result.allowed_tools`	array	允许使用的工具列表。
`result.abstract`	string	L0 摘要，按 level 条件返回。
`result.overview`	string	L1 概述，按 level 条件返回。
`result.content`	string	L2 SKILL.md 正文，按 level/include_content 条件返回。
`result.files`	array	文件清单，include_files=true 时返回。
`result.files[].name`	string	文件或目录名称。
`result.files[].uri`	string	文件或目录 URI。
`result.files[].path`	string	相对 Skill 根的路径。
`result.files[].is_dir`	bool	是否为目录。
`result.files[].kind`	string	`definition`、`summary`、`auxiliary` 或 `directory`。
`result.source`	object	来源追踪信息，include_source=true 时返回；未记录时 tracked=false。

完整示例

curl -X GET \
  "{BASE_URL}/api/v1/skills/search-web?level=2&include_files=true&include_source=true" \
  -H "Authorization: Bearer {API_KEY}"

{
  "status": "ok",
  "result": {
    "type": "skill",
    "name": "search-web",
    "uri": "viking://user/alice/skills/search-web",
    "root_uri": "viking://user/alice/skills/search-web",
    "skill_md_uri": "viking://user/alice/skills/search-web/SKILL.md",
    "description": "搜索互联网中的最新信息",
    "tags": ["search"],
    "allowed_tools": ["web"],
    "content": "# Search Web\n\n执行网络搜索。",
    "files": [
      {
        "name": "SKILL.md",
        "uri": "viking://user/alice/skills/search-web/SKILL.md",
        "path": "SKILL.md",
        "is_dir": false,
        "kind": "definition"
      }
    ],
    "source": {
      "tracked": true,
      "type": "api",
      "source": "inline_content",
      "operation": "add",
      "skill_name": "search-web"
    }
  }
}

最近更新时间：2026.07.22 18:07:44

这个页面对您有帮助吗？

有用

无用

向量数据库VikingDB

概述 #

请求接口 #

请求参数 #

响应消息 #

完整示例 #

概述

请求接口

请求参数

响应消息

完整示例