# execute_cloud_skill

通过隔离的 execution engine 运行 active Cloud Skill 中声明的一个 script component。

- Canonical: https://docs.xmemo.dev/zh/docs/tools/execute-cloud-skill
- Locale: zh-CN
- Content-Locale: zh-CN
- Canonical-Content-Digest: aba94d94556b98106266c559e78f7c9d3f934fda4c6f83458f67a7a938bb42c9
- Edition-Digest: 4a2741cda0e3c04e17359cb75f74508df7cdf67ba128434d1d09353e98a7d654
- Source-Revision: sha256:23bbbd009c5356d1653ef90add53c2a5821b45798e2ded6d766cdffe5bd291f5

## Tool Reference: `execute_cloud_skill`

### Purpose

通过隔离的 SandboxExecutionEngine 执行 active Cloud Skill 中声明的一个 script component。

### Parameters

- `script_path` (string, optional): 要执行的 script component 的 logical path 或 component ID。
- `slug` (string, optional, default: empty): 用于解析 active skill 的 skill slug。
- `skill_id` (string, optional, default: empty): 作为 slug 替代项的稳定 skill identity。
- `revision_id` (string, optional, default: empty): 可选的 revision pin；否则依次选择 published revision，再选择 latest revision。
- `input_args` (object, optional, default: empty object): 编码后写入 script stdin 的 JSON-compatible values。
- `timeout_seconds` (integer, optional, default: 30): 由 ExecutionLimits 限制为 1–60 秒的执行 timeout。

### Returns

JSON CloudSkillResponseEnvelope，kind='execution'，data 包含 execution_id、skill_id、revision_id、script_path、runtime、status、exit_code、stdout、stderr、truncation flags、可选 output_data、duration_ms、memory_peak_bytes、cpu_time_ms、timestamps 和 error_kind。

### Errors

- ACCESS_DENIED、SKILL_NOT_FOUND 或 SKILL_ARCHIVED：无法在 caller 的 scope 内解析 skill。
- REVISION_NOT_FOUND：请求的 revision 不属于该 skill，或不存在 active revision。
- SCRIPT_NOT_FOUND 或 INVALID_COMPONENT_TYPE：path 不存在，或指向非 script component。
- SANDBOX_UNAVAILABLE：host 没有可用的 bubblewrap isolation driver，且不安全 fallback 已禁用。
- EXECUTION_TIMEOUT、RESOURCE_EXHAUSTED 或 SCRIPT_EXECUTION_ERROR：watchdog、resource limits 或 script exit status 终止了执行。

### Examples

#### 运行一个 pinned script component



```typescript
execute_cloud_skill({
  slug: "deployment-procedure",
  revision_id: "revision-id-from-root-recall",
  script_path: "scripts/check.py",
  input_args: { environment: "staging" },
  timeout_seconds: 30
})
```

### Related Tools

- [recall_cloud_skill](/docs/tools/recall-cloud-skill): 在执行前发现 skill，并 pin revision/resource。
- [save_cloud_skill](/docs/tools/save-cloud-skill): 创建可以执行的 procedure 和 script component。
- [recall_context](/docs/tools/recall-context): 围绕执行 task 组装有界的 agent context。

## 按 script path 和 revision 执行

选择 active skill；需要可复现性时 pin 一个 revision，并指定 type 为 script 的 component。执行需要 memory:write，并返回 typed execution envelope。