# workflow

> 开发工作流工具。dev_loop: 执行 GDScript,可选项目验证/bridge 截图查询/验收断言/状态保存。scene_snapshot: 结构化场景树快照。batch_validate: 批量验证多个脚本。

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

## Actions

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

## Parameters

| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `action` | enum (6 项) | ✓ | 操作类型。dev_loop=执行+验证一体, scene_snapshot=场景树快照, batch_validate=批量脚本验证 |
| `project_path` | string |  | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） |
| `code` | string |  | dev_loop: 要执行的 GDScript 代码(片段或完整 extends SceneTree) |
| `verify` | boolean |  | dev_loop: 执行后是否跑项目验证(默认 false) |
| `timeout` | number |  | dev_loop: 每步超时秒数(默认 30) |
| `load_autoloads` | boolean |  | dev_loop: 是否加载 Autoload 上下文(默认 true) |
| `bridge` | object |  | dev_loop: 可选 Game Bridge,代码执行后截图/查询验证 |
| `acceptance` | object |  | dev_loop: 可选验收标准 |
| `save_state` | object |  | dev_loop: 保存会话状态到文件 |
| `scene_path` | string |  | scene_snapshot: 场景文件路径(相对项目) |
| `max_depth` | number |  | scene_snapshot: 最大遍历深度(默认 5) |
| `scripts` | array |  | batch_validate: 脚本路径数组(相对项目) |
| `godot_path` | string |  | 覆盖 Godot 二进制路径（可选，优先于项目配置和环境变量） |

## 风险分布

读 3 / 写 1 / 进程 2

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