# recall_cloud_skill

发现 Cloud Skill、加载 root manifest，或从明确 pin 的 revision 获取一个 resource。

- Canonical: https://docs.xmemo.dev/zh/docs/tools/recall-cloud-skill
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: a66c09970d11396c99dee1375dcc4f98f14752723e76286acb0b1929010be8fc
- Edition-Digest: 4a0e9407fb9d924373b0a02a1eed27f6562678b2ed39a05735998560c2d2d486
- Source-Revision: sha256:ede99f126c525b2202720b7cc58a07f4545e9b33620f111c105e26739e87783c

## Tool Reference: `recall_cloud_skill`

### Purpose

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

### Parameters

- `query` (string, optional, default: empty): Level 0 discovery text；skill_id 和 slug 为空时使用。
- `skill_id` (string, optional, default: empty): 用于 root 或 resource recall 的稳定 Cloud Skill identity。
- `slug` (string, optional, default: empty): 用于 root 或 resource recall 的人类可读 skill identity。
- `revision_id` (string, optional, default: empty): 可选的 root revision pin；Level 2 resource recall 必填。
- `resource` (string, optional, default: empty): 用于 Level 2 recall 的 logical component path 或 component ID。

### Returns

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。

### Errors

- 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。

### Examples

#### 发现 published skill



```typescript
recall_cloud_skill({ query: "deployment verification" })
```

#### 加载 pinned script resource



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

### Related Tools

- [save_cloud_skill](/docs/tools/save-cloud-skill): 创建持久 skill 或发布它的下一个 revision。
- [execute_cloud_skill](/docs/tools/execute-cloud-skill): 通过 sandbox 执行召回的 script component。
- [recall_context](/docs/tools/recall-context): 当目标是 agent memory 而非 Cloud Skill resource 时，使用 memory context retrieval。

## 只加载所需的层级

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