unity-batch

1## Triggers
2- Operating on many objects at once
3- Running or polling long async jobs
4- Preview-then-commit bulk edits
5- 一次性操作大量对象、运行或轮询长时异步任务、先预览后提交的批量编辑
6 
7# Unity Batch Skills
8 
9The `POST /skills/batch` endpoint, query → preview → execute bulk edits, execution reports and async jobs. Parameters come from the schema, never from a skill's name; execution and dryRun rules: root [SKILL.md](../../SKILL.md).
10 
11## POST /skills/batch — several skills, one HTTP call
12 
13An **HTTP endpoint, not a skill**: never send `skills_batch` to `POST /skill/<name>`. It runs up to 50 ordinary skill calls in order inside one main-thread job, each through the full single-skill pipeline (validation, permission gate, its own Undo group, audit): one round trip and one main-thread wake-up instead of N, the biggest saving once there are 3+ writes.
14 
15```json
16POST /skills/batch
17{
18  "steps": [
19    {"skill": "gameobject_create", "args": {"name": "Cube", "primitiveType": "Cube"}},
20    {"skill": "component_add", "args": {"instanceId": {"$ref": "$0.instanceId"}, "componentType": "Rigidbody"}}
21  ],
22  "continueOnError": false
23}
24```
25 
26| Body field | Default | Meaning |
27|---|---|---|
28| `steps` | required | `{skill, args}` objects, in order. More than 50 → `400 SEMANTIC_INVALID`; split the call. |
29| `continueOnError` | `false` | `false` = stop at the first failure; `true` = record it and keep going. |
30…