unity-light

1> **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.
2 
3## Triggers
4- Adding or tuning lights
5- Setting up scene lighting
6- Batch-enabling/disabling lights
7- 添加或调校灯光、布置场景照明、批量开关灯光
8 
9# Unity Light Skills
10 
11> **BATCH-FIRST**: Use `*_batch` skills when operating on 2+ lights.
12 
13## Operating Mode
14 
15- **Approval** (default): mutating skills (`light_create`, `light_set_properties`, `light_set_properties_batch`, `light_set_enabled`, `light_set_enabled_batch`, `light_add_probe_group`, `light_add_reflection_probe`) need user grant; grant triggers a single server-side execution that returns the result.
16- **Auto / Bypass**: those skills execute directly.
17- Query skills (`light_get_info`, `light_get_properties`, `light_find_all`, `light_get_lightmap_settings`) are `SkillMode.SemiAuto` — they run in all three modes without grant.
18- This module contains **no** Delete / PlayMode / Reload / high-risk skills (no NeverInSemi); to remove a Light, call `gameobject_delete` from the `gameobject` module.
19 
20## Guardrails
21 
22**DO NOT** (common hallucinations):
23- `light_add` does not exist → use `light_create` (creates a new light GameObject)
24…