mobile-agent: Skill for Windsurf

mobile-automation

Mobile MCP + 飞书 MCP 双协作自动化测试专家。

核心能力：

• 飞书多维表格用例管理（读取、执行、回写结果）
• Mobile MCP 移动端自动化（Android/iOS）
• 智能重试与降级策略
• 每10条用例自动分批，打开新会话继续
• Token 优化策略（减少 80% 的截图消耗）

触发关键词：手机自动化、移动端测试、App 测试、mobile_mcp、点击手机、操作手机、执行飞书用例、批量执行、多维表格

---

🔗 双MCP协作架构

┌─────────────────────────────────────────────────────────────┐
│                     AI（Windsurf）                           │
│                                                             │
│   ┌──────────────┐              ┌──────────────┐           │
│   │  飞书 MCP    │              │  Mobile MCP  │           │
│   │              │              │              │           │
│   │ • 读取用例   │              │ • 启动App    │           │
│   │ • 写入结果   │              │ • 点击元素   │           │
│   │ • 更新状态   │              │ • 输入文本   │           │
│   └──────┬───────┘              └──────┬───────┘           │
│          │                             │                    │
│          ▼                             ▼                    │
│   ┌──────────────┐              ┌──────────────┐           │
│   │ 飞书多维表格 │              │   手机设备   │           │
│   └──────────────┘              └──────────────┘           │
└─────────────────────────────────────────────────────────────┘

🎯 核心原则

1. Token 优化（最重要）

永远优先使用 list_elements，而不是截图！

方式	Token 消耗	使用场景
list_elements	~500	✅ 确认页面状态、查找元素
take_screenshot	~2000	❌ 只在需要视觉分析时使用

❌ 错误流程：截图 → 分析 → 点击 → 截图确认
✅ 正确流程：list_elements → 点击 → list_elements 确认

2. 工具选择优先级

点击元素时，按以下优先级选择工具：

1️⃣ click_by_text（最稳定，跨设备兼容）
   ↓ 找不到文本？
2️⃣ click_by_id（需要 resource-id）
   ↓ 没有 id？
3️⃣ click_by_percent（百分比坐标，跨分辨率）
   ↓ 复杂场景？
4️⃣ click_at_coords（兜底，需要截图获取坐标）

3. 验证策略

使用 verify 参数减少额外调用：

# ❌ 低效（3次调用）
list_elements()
click_by_text("登录")
list_elements()  # 确认

# ✅ 高效（2次调用）
list_elements()
click_by_text("登录", verify="首页")  # 自动验证"首页"出现

---

📱 常见场景

场景 1：启动 App 并处理弹窗

# 标准流程
1. launch_app("com.example.app")
2. wait(2)  # 等待启动
3. close_popup()  # 自动检测并关闭弹窗（无需先截图）
4. list_elements()  # 确认主页面