Unity Scene Skills

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Opening or saving scenes
• Loading additively
• Switching active scene
• Querying scene contents
• 打开或保存场景、叠加加载、切换活动场景、查询场景内容

Unity Scene Skills

Control Unity scenes - the containers that hold all your GameObjects.

Operating Mode

• Approval：本模块 Mixed —— scene_get_info / scene_get_hierarchy / scene_get_loaded / scene_find_objects 标 SkillMode.SemiAuto，可直接执行；scene_screenshot / scene_unload / scene_set_active 未设 Mode 字段（默认 FullAuto），Approval 模式下需 grant。
• Auto / Bypass：FullAuto 直接执行。
• 含 NeverInSemi 高危 skill：scene_create / scene_load / scene_save（标 RiskLevel="high"，因为切换/覆盖整个场景文件影响范围极大）。这些在 Approval/Auto 下返 MODE_FORBIDDEN，仅 Bypass 或 Allowlist 命中可调。

DO NOT (common hallucinations):

• scene_delete / scene_rename do not exist → delete scene files via asset_delete, rename via asset_move
• scene_list does not exist → use scene_get_loaded (loaded scenes) or asset_find with t:Scene (all scene assets)
• scene_find_objects is a simple name/tag/component filter; for regex/layer/path search use gameobject_find (SkillMode.SemiAuto, 只读，任何模式可直接调用)

Routing:

• For detailed hierarchy tree → use perception module's hierarchy_describe
• For scene statistics → use perception module's scene_summarize
• For screenshot → scene_screenshot (this module) captures the Game View final composited image (all cameras + UI; in Play mode this is the live runtime frame); camera_screenshot (camera module, SkillMode.FullAuto) renders a single Game Camera off-screen

Skills Overview