/workflow

name: unity-workflow
description: Persistent operation history and orchestration

> **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

• Undoing a whole task or session
• Snapshotting before risky changes
• Planning/previewing batch operations
• Rolling back
• 撤销整个任务或会话、高危改动前快照、规划/预览批量操作、回滚

Workflow Skills

Persistent history and rollback system for AI operations ("Time Machine"). Allows tagging tasks, snapshotting objects before modification, and undoing specific tasks even after Editor restarts.

**NEW: Session-level undo** - Group all changes from a conversation and undo them together.

Operating Mode

• **Approval**：本模块大部分 skill 标 `SkillMode.SemiAuto`（bookmark / history / task / session 系列里的纯读查询 + `workflow_plan`，后者 ReadOnly=true 仅生成聚合计划），可直接执行。有副作用的 skill (`bookmark_set` / `bookmark_goto` / `workflow_snapshot_object` / `workflow_snapshot_created` / `batch_retry_failed`) 走默认 `SkillMode.FullAuto`，需 grant。
• **Auto / Bypass**：FullAuto 直接执行。
• **含 NeverInSemi 高危 skill**：`bookmark_delete` / `workflow_delete_task`（标 Operation.Delete，删除书签/任务记录）、`workflow_clear_history`（Operation.Delete + RiskLevel=high，清空全部历史+redo栈+文件存储，不可逆）。这些在 Approval/Auto 下返 `MODE_FORBIDDEN`，仅 Bypass 或 Allowlist 命中可调。

> 注意：`workflow_undo_task` / `workflow_session_undo` 不是 Delete operation（标的是 Modify/Execute），它们能在 Approval/Auto 直接撤销已记录任务。

**Surface profile:** `workflow_undo_task` / `workflow_redo_task` / `workflow_revert_task` / `workflow_session_undo` inspect every snapshot the target task(s) would restore. If any snapshot would author a category the active profile withdraws — a scene GameObject, or a `.unity` / `.mat` asset — the whole call is refused with `SURFACE_EXCLUDED` (`surfaceProfile`/`category`/`operation`/`manualDoc`/`userControlled`/`hint` at the top level, not nested under `details`) rather than partially applied. Snapshots of scripts, prefabs, textures, ScriptableObjects, and Editor/project settings are unaffected — those stay undoable under every profile.

**DO NOT** (common hallucinations):

• `workflow_save` does not exist → use `workflow_task_end` to end and save a task
• `workflow_rollback` does not exist → use `workflow_undo_task` (by taskId) or `workflow_session_undo` (by sessionId)
• `workflow_create` does not exist → use `workflow_task_start`
• `workflow_revert_task` is deprecated → use `workflow_undo_task`

**Routing**:

• For simple undo/redo (1 step) → `editor_undo` / `editor_redo` (editor module)
• For multi-step undo → `history_undo` with `steps` parameter (this module)
• For conversation-level undo → `workflow_session_undo` (this module)

Bookmark Skills

`bookmark_set`

Save current selection and scene view position as a bookmark.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | bookmarkName | string | Yes | - | Name for the bookmark | | note | string | No | null | Optional note for the bookmark |

**Returns:** `{ success, bookmark, selectedCount, hasSceneView, note }`

`bookmark_goto`

Restore selection and scene view from a bookmark.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | bookmarkName | string | Yes | - | Name of the bookmark to restore |

**Returns:** `{ success, bookmark, restoredSelection, note }`

`bookmark_list`

List all saved bookmarks.

No parameters.

**Returns:** `{ success, count, bookmarks: [{ name, selectedCount, hasSceneView, note, createdAt }] }`

`bookmark_delete`

Delete a bookmark.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | bookmarkName | string | Yes | - | Name of the bookmark to delete |

**Returns:** `{ success, deleted }`

History Skills

`history_undo`

Undo the last operation (or multiple steps).

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | steps | int | No | 1 | Number of undo steps to perform |

**Returns:** `{ success, undoneSteps }`

`history_redo`

Redo the last undone operation (or multiple steps).

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | steps | int | No | 1 | Number of redo steps to perform |

**Returns:** `{ success, redoneSteps }`

`history_get_current`

Get the name of the current undo group.

No parameters.

**Returns:** `{ success, currentGroup, groupIndex }`

Planning And Batch Governance

`workflow_plan`

Generate a combined execution plan for multiple skills on the server side.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `skillsJson` | string | Yes | - | JSON array of `{ "name": "...", "params": { ... } }` entries |

**Returns:** `{ totalSteps, totalRisk, steps, dependencies, warnings, mayDisconnect }`

`batch_query_assets`

Query project assets with filters that are useful before batch cleanup or migration work.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `searchFilter` | string | No | - | Extra `AssetDatabase.FindAssets` filter text | | `folder` | string | No | `Assets` | Search root | | `typeFilter` | string | No | - | Asset type filter such as `t:Material` or `Prefab` | | `namePattern` | string | No | - | Regex applied to file name without extension | | `labelFilter` | string | No | - | Asset label filter such as `l:Addressable` | | `maxResults` | int | No | `200` | Max assets returned |

**Returns:** `{ count, totalMatched, summary, assets }`

`batch_retry_failed`

Retry only the failed items from an earlier b