unity-workflow（Unity 工作流）

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.

Guardrails

Mode: Semi-Auto (available by default)

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.

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

bookmark_goto

Restore selection and scene view from a bookmark.

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.

Returns: {success, deleted}

History Skills

history_undo

Undo the last operation (or multiple steps).

Returns: {success, undoneSteps}

history_redo

Redo the last undone operation (or multiple steps).

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.

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

batch_query_assets

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

Returns: {count, totalMatched, summary, assets}

batch_retry_failed

Retry only the failed items from an earlier batch execution report. This now reuses the original operation context stored in the report.

Returns: {status, jobId?, retryCount, originalReportId, reportId?}

Session Management (Conversation-Level Undo)

workflow_session_start

Start a new session (conversation-level). All changes will be tracked and can be undone together. Call this at the beginning of each conversation.

Returns: {success, sessionId, message}

workflow_session_end

End the current session and save all tracked changes. Call this at the end of each conversation.

No parameters.

Returns: {success, sessionId, message}

workflow_session_undo

Undo all changes made during a specific session (conversation-level undo).

Returns: {success, sessionId, message}

workflow_session_list

List all recorded sessions (conversation-level history).

No parameters.

Returns: {success, count, currentSessionId, sessions: [{sessionId, taskCount, totalChanges, startTime, endTime, tags}]}

workflow_session_status

Get the current session status.

No parameters.

Returns: {success, hasActiveSession, currentSessionId, isRecording, currentTaskId, currentTaskTag, currentTaskDescription, snapshotCount}

Task-Level Skills

workflow_task_start

Start a new persistent workflow task to track changes for undo. Call workflow_task_end when done.

Returns: {success, taskId, message}

workflow_task_end

End the current workflow task and save it. Requires an active task (call workflow_task_start first).

No parameters.

Returns: {success, taskId, snapshotCount, message}

workflow_snapshot_object

Manually snapshot an object's state before modification. Requires an active task (call workflow_task_start first). Call this BEFORE component_set_property, gameobject_set_transform, etc.

Returns: {success, objectName, type}

workflow_snapshot_created

Record a newly created object for undo tracking. Requires an active task (call workflow_task_start first). Note: component_add and gameobject_create automatically record created objects, so you typically don't need to call this manually.

Returns: {success, objectName, type}

workflow_list

List persistent workflow history.

No parameters.

Returns: {success, count, history: [{id, tag, description, time, changes}]}

workflow_undo_task

Undo changes from a specific task (restore to previous state). The undone task is saved and can be redone later.

Returns: {success, taskId}

workflow_redo_task

Redo a previously undone task (restore changes).

Returns: {success, taskId}

workflow_undone_list

List all undone tasks that can be redone.

No parameters.

Returns: {success, count, undoneStack: [{id, tag, description, time, changes}]}

workflow_revert_task

(deprecated) Alias for workflow_undo_task. Use workflow_undo_task instead.

Returns: {success, taskId}

workflow_delete_task

Delete a task from history (does not revert changes, just removes the record).

Returns: {success, deletedId}

Minimal Example

import unity_skills

# Session-level: wrap entire conversation for bulk undo
unity_skills.call_skill("workflow_session_start", tag="Build Player")
unity_skills.call_skill("gameobject_create", name="Player", primitiveType="Capsule")
unity_skills.call_skill("component_add", name="Player", componentType="Rigidbody")
unity_skills.call_skill("workflow_session_end")
# Later: undo entire session
sessions = unity_skills.call_skill("workflow_session_list")
unity_skills.call_skill("workflow_session_undo", sessionId=sessions["sessions"][0]["sessionId"])

Auto-Tracked Operations

The following operations are automatically tracked for undo when a session/task is active:

• gameobject_create / gameobject_create_batch
• gameobject_duplicate / gameobject_duplicate_batch
• component_add / component_add_batch
• ui_create_* (canvas, button, text, image, etc.)
• light_create
• prefab_instantiate / prefab_instantiate_batch
• material_create / material_duplicate
• terrain_create
• cinemachine_create_vcam

For modification operations, the system auto-snapshots target objects before changes when possible.

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.