ARTICLE · 1383766
同样用 Cursor 做 App 自动化,为什么别人的工程能长期维护,你的一改就崩?
Cursor新玩法|一套Skill,搞定可长期维护的App自动化
上周帮同事排查一套App自动化脚本,越看越无奈。
他在Cursor里直接让AI生成Appium代码,忙活大半天,脚本跑一次就成功,页面改一行样式,整个用例直接集体瘫痪。
没有业务梳理、没有风险记录、没有统一规范,一堆零散脚本躺在仓库里,没人敢接手维护。
很多测试同学都卡在这一步:AI能快速产出代码,却很难交付一套稳定、可持续迭代的自动化工程。

今天给大家分享部署在Cursor里的 mobile-app-autotest Skill,它的核心思路不是帮你一键写完代码,而是建立一套标准化交付流程:先理清业务现状 → 选定运行环境 → 梳理测试清单 → 生成自动化资产 → 质量自检 → 输出可读中文报告,把自动化从“写脚本”变成一套可复盘、有门禁的工程化动作。
🧩 它到底是什么?
它是一套放在 .cursor/skills/mobile-app-autotest/ 下的AI协作规范包,不是独立测试框架,而是用来约束Cursor Agent产出Appium自动化工程的工作说明书,配套轻量脚本、模板、排障文档。

整体分为三层:
- 协作层
:以SKILL.md作为核心,定义触发规则、交付步骤、验收门槛 - 脚本层
:Shell、Python轻量脚本,负责环境诊断、自动生成业务清单,无额外依赖 - 产物层
:机器识别JSON清单、可执行测试代码、面向业务的中文交付文档
默认技术栈基于 Appium 3.x,Android 使用 UiAutomator2,iOS 使用 XCUITest。优先沿用项目现有技术栈,没有约定时默认 Java + TestNG,所有测试代码统一放在 mobile-tests/ 目录。
提醒:Skill本身不带Appium安装包,使用前依然需要自行安装Appium和对应驱动。
✅ 适合哪些场景?
✅ 项目从零搭建移动端回归自动化 ✅ 已有零散脚本,想要统一梳理业务覆盖缺口 ✅ 需要同时交付安卓、iOS双端自动化 ✅ 原生+H5混合App,频繁遇到WebView切换难题 ✅ 云真机批量回归,需要产出给领导、产品看的中文简报
⚠️ 谨慎使用:团队已经深度使用 Detox / Maestro;纯游戏自定义渲染UI(需要单独定制定位方案)
输入材料:APK/IPA包或者云真机包地址、应用包标识、目标平台;可选补充现有项目编码规范、P0核心流程。
交付产物:业务清单文件、双端配置、页面对象、业务流程用例、工具封装、失败截图、中文总结报告。
📌 两大核心设计,决定脚本能不能扛住迭代
1. 元素定位优先级体系
拒绝无脑XPath,建立层级约束:
accessibility id/ content-desc/label|跨端首选Android resource-id / iOS name|平台稳定属性 iOS predicate / class chain|结构查询 Android UiAutomator|滚动等特殊场景 XPath|仅兜底,必须标注使用理由
同时硬性禁止:固定坐标、Thread.sleep,全部使用显式等待。
2. 五维质量打分机制
交付前必须自评,总分低于70分不能交付:
可运行性 25%:P0流程可正常启动,无硬编码本地路径 定位健壮性 25%:核心流程不依赖裸XPath,关键控件有稳定标识 可维护性 20%:页面、业务流程分层,配置统一管理 稳定性 15%:无死等待,失败自动截图,超时策略合理 覆盖透明度 15%:有业务清单,风险点显性标注
配套故障诊断决策树,遇到报错按路径排查,避免同时修改多个配置、越修越乱。

🚀 手把手8步落地流程
前置准备
装好 Node.js、Python 3.8+;Android准备JDK、SDK;iOS需要Mac+Xcode;确认Skill文件部署完成,准备好测试安装包。
- 环境预检运行环境检测脚本,自动校验Node、Appium、驱动、adb、端口状态。4723端口未就绪时,手动拉起Appium服务。
- 生成业务清单执行清单生成脚本,输出
app-test-manifest.json,自动梳理页面、业务链路、潜在风险(比如H5页面切换)。重点:清单一定要人工核对P0流程,确认和真实业务对齐,再生成代码,避免全盘返工。
- 启动Appium服务,生成完整工程在Cursor里下发指令,基于清单文件生成整套PO结构工程。自动区分安卓、iOS配置,跨平台注解自动生成,封装手势、等待、截图工具,预留WebView上下文处理逻辑。
- 质量自检 + 中文交付对照质量标准逐项校验,冒烟失败就走故障树排查修复;最终输出中文总结,写明覆盖范围、风险点、环境短板、后续优化方向,用于团队评审。
📂 统一目录规范(纳入Git管理)
你的项目根目录├── app-test-manifest.json # 给AI、脚本读取的业务清单└── mobile-tests/ ├── config/ # 会话、能力配置 ├── screens/ # 页面对象 ├── flows/ # 业务流程用例 ├── utils/ # 公共工具 ├── fixtures/ # 测试账号(严禁存放密码) └── reports/ # 截图 + 中文交付报告分工小技巧:JSON清单给工具链路使用,中文摘要给产品、负责人评审,代码交给测试开发维护,各司其职。
💡 给测试工程师的实战建议
- 清单先行,用例后置
,不要跳过梳理环节直接堆脚本,业务理解错了,写再多代码都无效。 和开发对齐:核心交互控件尽量预埋 testID,从源头提升定位稳定性。混合App测试,H5操作完成后,记得切回原生上下文,防止后续步骤静默失败。 设备能力配置统一收拢在Session工厂,不要散落在各个用例里。 本地冒烟、云真机回归分开配置,通过运行面配置文件统一管理。
❓ 高频踩坑快速参考
会话启动失败:优先检查Appium服务、驱动是否正常安装 元素找不到:核对定位策略,排查是否停留在H5上下文 间歇性不稳定:删掉固定sleep,改用显式等待;关闭设备动画 云真机识别不到包:确认安装包已经上传,核对Hub地址信息
✍️ 写在最后
自动化的价值,从来不是“能跑起来”,而是长期可维护、可追溯、可扩展。
这套Skill本质是把测试工程师的工程经验固化成AI协作规则,让Cursor不再只产出一次性脚本,而是帮你搭建一套可以跟着业务持续迭代的移动端自动化体系。
建议先用一个简单Demo App完整跑一遍全流程,把这套流程跑顺之后,再落地到正式业务项目。

#软件测试 #App自动化 #Cursor #AI测试 #Appium #测试开发#软件测试工程师 #Skill #Web测试















































































