# workflow

> Development workflow tools. dev_loop: execute GDScript with optional validation, bridge queries, and state saving. scene_snapshot: capture structured scene tree snapshot. batch_validate: validate multiple GDScript files at once.

| 属性 | 值 |
|------|-----|
| 所属层 | headless |
| 安全级别 | guarded |
| 需要 Godot | 是 |
| 需要编辑器 | 否 |
| 只读 | 否 |
| 长耗时 | 是 |

## Actions

- `dev_loop`
- `scene_snapshot`
- `batch_validate`
- `create_files`
- `run_verify`
- `diff_scenes`

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (6 项) | ✓ | Action type |
| `project_path` | string |  | Path to Godot project directory |
| `code` | string |  | dev_loop: GDScript code to execute (snippet or full extends SceneTree) |
| `verify` | boolean |  | dev_loop: Also run project validation after execution (default: false) |
| `timeout` | number |  | dev_loop: Timeout per step in seconds (default: 30) |
| `load_autoloads` | boolean |  | dev_loop: Load Autoload context (default: true) |
| `bridge` | object |  | dev_loop: Optional Game Bridge for screenshot/query validation |
| `acceptance` | object |  | dev_loop: Optional acceptance criteria |
| `save_state` | object |  | dev_loop: Save session state to file |
| `scene_path` | string |  | scene_snapshot: Scene file path relative to project |
| `max_depth` | number |  | scene_snapshot: Max tree depth (default: 5) |
| `scripts` | array |  | batch_validate: Array of script paths relative to project |
| `godot_path` | string |  | 覆盖 Godot 二进制路径（可选，优先于项目配置和环境变量） |

## 风险分布

读 3 / 写 1 / 进程 2

---
<!-- AUTO-GENERATED by scripts/gen-tool-docs.mjs from capability-matrix.json v0.32.21. DO NOT edit manually; re-run npm run gen:tool-docs after tool changes. -->