chore: push all design docs, V2 plan specs, and current working state

Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2,
AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code
changes across packages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

AirPlan/docs/spec/AirPlanV2/commands/xdb.md

@@ -0,0 +1,43 @@
+---
+description: "AirPlan xdb mode - GUI validator with DRM/KMS native screenshot and headless CI"
+argument-hint: "[capture]"
+allowed-tools: "[Read, Glob, Grep, Bash, Write, Edit]"
+---
+
+# /xdb
+
+AirXDB 是 GUI 验证器。支持 DRM/KMS 原生截图（kmsgrab）、Xvfb headless 截图、多后端自动降级。
+
+## 截图后端
+
+| 后端 | --prefer 值 | 适用场景 |
+|------|------------|---------|
+| KMS grab | `kms` | 嵌入式 DRM/KMS 显示 |
+| Xvfb | `xvfb` | CI headless 环境 |
+| fallback | `fallback` | 通用桌面环境 |
+| auto | `auto` | 自动检测（默认，按 kms → xvfb → fallback 尝试） |
+
+## 子命令
+
+### 截图采集
+
+```bash
+python scripts/airplan.py --mode xdb --project . --prefer auto --output screenshot.png
+```
+
+参数：
+- `--prefer`：截图后端偏好（默认 `auto`）
+- `--output`：输出文件名（默认 `screenshot.png`）
+
+返回 `{success, method, output, error}`。
+
+## 集成路径
+
+**Dbg 取证**：Dbg 在 `confirm_symptoms` 步骤调 xdb 获取截图证据：
+```bash
+python scripts/airplan.py --mode xdb --project . --prefer auto --output debug-screenshot.png
+```
+
+**Do Worker GUI 任务验证**：涉及 GUI/UI/Render 的任务，finish 前必须有截图证据。Worker 调 xdb 采集后，将截图路径写入 result.json 的 validations 字段。
+
+**证据门控**：`EvidenceGatePolicy` 检测到任务含 GUI 关键词时，自动要求 xdb 截图证据。