recall_cloud_skill

只加载所需的层级

从 query discovery 开始，然后使用返回的 skill 或 revision identifier 执行 root 和 resource recall。Level 2 resource read 需要显式的 revision_id。

公开 MCP 工具

recall_cloud_skill

用途

分阶段发现 Cloud Skill、召回一个 root revision 和 manifest，或从明确 pin 的 revision 获取一个 resource。

适用场景

当 agent 需要按 name、slug 或 description terms 发现可复用的 published skill 时，从 query 开始。
在决定是否需要某个 component 前，加载 root instructions 和 resource manifest。
从 Level 1 选定的 revision 获取一个准确的 reference、example、template、document、artifact 或 script。

不适用场景

没有 root recall 返回的 revision_id 时，不要发起 Level 2 resource request；service 会拒绝未 pin 的 resource read。
不要把 Level 0 的 descriptor 当作 skill instructions；它只是 discovery metadata。
不要用它执行 script；确认 pinned revision 和 script path 后应使用 execute_cloud_skill。
不要期待返回 archived skill 或认证 personal/team scope 之外的 skill。

所需权限范围

MCP surface 需要 memory:read。
这个 advanced tool 会在认证的 personal 或 team scope 内解析 skill，不会扩大该 boundary。

参数列表

参数名	类型	描述
`query`	string · 默认值: empty	Level 0 discovery text；skill_id 和 slug 为空时使用。
`skill_id`	string · 默认值: empty	用于 root 或 resource recall 的稳定 Cloud Skill identity。
`slug`	string · 默认值: empty	用于 root 或 resource recall 的人类可读 skill identity。
`revision_id`	string · 默认值: empty	可选的 root revision pin；Level 2 resource recall 必填。
`resource`	string · 默认值: empty	用于 Level 2 recall 的 logical component path 或 component ID。

返回模式

JSON CloudSkillResponseEnvelope：Level 0 的 kind='descriptor' 并包含 descriptor data；Level 1 的 kind='root' 并包含 instructions、revision metadata、canonical_hash、warnings 和 resources；Level 2 的 kind='resource' 并包含 pinned component content/hash；失败时使用 kind='error' 和 CloudSkillErrorPayload。

使用示例

发现 published skill

recall_cloud_skill({ query: "deployment verification" })

加载 pinned script resource

recall_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  resource: "scripts/check.py"
})

错误信息

ACCESS_DENIED：请求的 skill ID 不属于认证的 personal/team scope。
SKILL_NOT_FOUND 或 SKILL_ARCHIVED：没有 active skill 与提供的 identity 匹配。
REVISION_NOT_FOUND：无法为该 skill 解析请求的或 published revision。
REVISION_PINNING_VIOLATION：Level 2 resource request 缺少 revision_id。
RESOURCE_NOT_FOUND：pinned revision 中不存在该 logical resource path 或 component ID。

save_cloud_skill — 创建持久 skill 或发布它的下一个 revision。
execute_cloud_skill — 通过 sandbox 执行召回的 script component。
recall_context — 当目标是 agent memory 而非 Cloud Skill resource 时，使用 memory context retrieval。

来源: Cloud Skills