用途：unity-sample 属于 unity-skills 的示例与演示技能模块，主要用于测试 REST 服务可达性、冒烟测试连通性，以及尝试第一次调用。它提供基础示例，用于验证 API 是否正常工作。
主要能力：模块包含一批基础示例技能。create_cube 和 create_sphere 用于创建立方体与球体图元，参数为 x、y、z、name；delete_object 按名称删除对象，参数为 objectName；find_objects_by_name 查找名称包含指定字符串的对象，参数为 nameContains，也接受 name 作为兼容别名；set_object_position、set_object_rotation、set_object_scale 分别设置对象位置、旋转与缩放，参数为 objectName、x、y、z；get_scene_info 获取当前场景信息，无参数。
使用方式与前置要求：调用该模块任何技能前，若参数是从技能名称或描述猜测而来，应先阅读相关文件，或通过 GET /skills/recommend?includeSchema=true 获取 schema；已从 recommend/schema 获得参数定义后，可直接进入 dryRun。技能的确切名称、参数、默认值与返回值由 GET /skills/schema 或 unity_skills.get_skill_schema() 定义，而非本说明文件。
运行模式与限制：采用 v1.9 三层模式。Approval 为默认模式，查询类技能（get_scene_info、find_objects_by_name）直接运行，创建/修改类技能（create_cube、create_sphere、set_object_position、set_object_rotation、set_object_scale）为 FullAuto，在 MODE_RESTRICTED 下需执行授权协议。Auto/Bypass 模式下 SemiAuto 与 FullAuto 直接运行。本模块中 delete_object（SkillOperation.Delete）在 Auto 下被禁止，只有在 Bypass 或用户管理的 Allowlist 条目下才可达，授权流程返回 MODE_FORBIDDEN。
表面配置限制：本模块的写入技能被视为另一名称下的 GameObject 创作，因此 guide 与 noSceneAuthoring 配置都会隐藏它们并返回 SURFACE_EXCLUDED，该排除无法通过模式或 Allowlist 绕过；guide 下 details.manualDoc 指向 manual-gameobject，手动教授相同的基础与变换步骤。查询技能在所有配置下均可用。SURFACE_EXCLUDED 还有第二个来源：可见的 shell 技能 batch_execute、batch_retry_failed 以及 workflow 模块的 undo/redo/revert，在应用负载落入当前配置撤销的类别时，执行时也返回相同代码。
注意事项：示例技能是基础测试/演示技能，不要用于生产工作；sample_create 是 gameobject_create 的简化版本，优先使用完整的 gameobject 模块；sample_hello/sample_ping 仅用于连通性测试。实际 GameObject 操作应使用 gameobject 模块，服务器健康检查应使用 Python 辅助的 unity_skills.health()。