/sample

name: unity-sample
description: Sample and demo skills for API connectivity testing. 用于 API 连通性测试的示例 skill。

Triggers

• Testing REST server reachability
• Smoke-testing connectivity
• Trying a first call
• 测试 REST 服务可达性、冒烟测试连通性、试发第一个调用

Sample Skills

Basic examples for testing the API.

Guardrails

**Operating Mode** (v1.9 three-tier):

• **Approval** (default): query skills (`get_scene_info`, `find_objects_by_name`) run directly. Creators/mutators (`create_cube`, `create_sphere`, `set_object_position`, `set_object_rotation`, `set_object_scale`) are FullAuto — on `MODE_RESTRICTED`, run the grant protocol.
• **Auto** / **Bypass**: SemiAuto and FullAuto run directly.
• Auto-forbidden in this module: `delete_object` (`SkillOperation.Delete`). It is reachable only under Bypass or via a user-managed Allowlist entry; the grant flow returns `MODE_FORBIDDEN`.

**DO NOT** (common hallucinations):

• Sample skills are basic test/demo skills — do not use them for production work
• `sample_create` is a simplified version of `gameobject_create` — prefer the full gameobject module
• `sample_hello` / `sample_ping` are connectivity test skills only

**Routing**:

• For actual GameObject operations → use `gameobject` module
• For server health check → use Python helper's `unity_skills.health()`

Skills

create_cube

Create a cube primitive. **Parameters:** `x`, `y`, `z`, `name`

create_sphere

Create a sphere primitive. **Parameters:** `x`, `y`, `z`, `name`

delete_object

Delete object by name. **Parameters:** `objectName`

`find_objects_by_name`

Find objects containing string. **Parameters:** `nameContains` (`name` is also accepted as a compatibility alias)

`set_object_position`

Set object position. **Parameters:** `objectName`, `x`, `y`, `z`

`set_object_rotation`

Set object rotation. **Parameters:** `objectName`, `x`, `y`, `z`

`set_object_scale`

Set object scale. **Parameters:** `objectName`, `x`, `y`, `z`

`get_scene_info`

Get current scene information. **Parameters:** None.

---

Exact Signatures

Exact names, parameters, defaults, and returns are defined by `GET /skills/schema` or `unity_skills.get_skill_schema()`, not by this file.