---
description: "AirPlan do mode - task executor with UI skill routing and evidence gate"
argument-hint: "[enter|status|finish]"
allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
---

# /do

AirDo 是任务执行器。运行单个任务，强制执行路由规则，集成其他 AirPlan 模式。

## 硬规则

1. **UI Task Handling (P1-20)** — 当任务涉及 UI/前端/界面时，检测并确保 frontend-design Skill 可用。不可用时阻止执行
2. **Evidence Gate (INV-4)** — GUI 任务需截图，网络任务需抓包，代码任务需静态分析/测试
3. **Force AirDbg Routing** — done 无证据 → airdbg；blocked/failed → airdbg

## 子命令

### enter — 进入 Worker

```bash
python scripts/airplan.py --mode do --project . --sub enter --task-id T-001 --task-text "实现登录界面UI"
```

参数：
- `--task-id`：任务 ID（必须）
- `--task-text`：任务描述文本（用于 UI 检测和路由，必须）

创建 `AirPlan/state/airdo/tasks/{task_id}/worker-state.json`。返回 `{taskId, briefPath, resultPath, workerStatePath, uiRouting}`。

### status — 查看 Worker 状态

```bash
python scripts/airplan.py --mode do --project . --sub status
```

### finish — 完成 Worker（含路由决策）

```bash
python scripts/airplan.py --mode do --project . --sub finish --task-id T-001 --result AirPlan/state/airdo/tasks/T-001/result.json
```

finish 执行强制路由：
- `done` + 有 validations/filesChanged → route to `merge`
- `done` + 无 evidence → forced route to `airdbg`
- `blocked`/`failed` → forced route to `airdbg`

## AirDbg 路由 — 具体操作

当 finish 返回 `routingDecision.target = "airdbg"` 时，**必须**调 dbg 模式：

```bash
# 1. 启动调试会话
python scripts/airplan.py --mode dbg --project . --sub start --task-id {tid}

# 2. Dbg 按 7 步工作流调试（取证→定位→修复→验证）
# 3. Dbg 完成后，重新 finish:
python scripts/airplan.py --mode do --project . --sub finish --task-id {tid} --result AirPlan/state/airdo/tasks/{tid}/result.json
```

## 证据采集 — GUI/Network 任务

**GUI 任务**（涉及 gui/ui/render/widget/dialog 等关键词）— 需要截图：
```bash
python scripts/airplan.py --mode xdb --project . --prefer auto --output task-{tid}-screenshot.png
```
截图路径写入 result.json 的 validations 字段。

**网络任务**（涉及 network/rtsp/http/tcp 等关键词）— 需要抓包：
```bash
python scripts/airplan.py --mode ndb --project . --sub enter
# 然后 tcpdump/tshark 抓包，存入 AirPlan/state/airndb/captures/
```

**代码任务** — 需要静态分析或测试：
```bash
python scripts/airplan.py --mode sdb --project . --backend cppcheck --target ./src
# 或
python scripts/airplan.py --mode tst --project . --sub run --task-id {tid} --framework googletest
```

## UI 任务检测关键词（中英文）

gui, ui, render, layout, dialog, osd, overlay, visual, widget, pane, toolbar, canvas, button, window, popup, menu, drm, kms, opengl, vulkan, frontend, react, vue, angular, web, css, html, 界面, 按钮, 对话框, 窗口, 菜单, 控件, 渲染, 布局