unity-sample
GitHub提供Unity API连通性测试及基础GameObject操作的示例技能，如创建、删除对象及获取场景信息。仅用于冒烟测试和演示，严禁在生产环境使用。
Trigger Scenarios
Install
npx skills add Besty0728/Unity-Skills --skill unity-sample -g -y
SKILL.md
Frontmatter
{
"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 — onMODE_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 returnsMODE_FORBIDDEN.
DO NOT (common hallucinations):
- Sample skills are basic test/demo skills — do not use them for production work
sample_createis a simplified version ofgameobject_create— prefer the full gameobject modulesample_hello/sample_pingare connectivity test skills only
Routing:
- For actual GameObject operations → use
gameobjectmodule - 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.
Version History
-
25d511e
Current 2026-08-13 09:15
压缩描述至指定字符数，并将路由说明移至Triggers部分
- ec9f870 2026-07-05 14:40
