用途
本技能面向移动端 QA 自动化，将人类可读的移动端工作流文档转换为一个自包含的 Playwright 测试项目，并针对移动视口进行优化。它读取 /workflows/mobile-workflows.md，把每个步骤翻译成符合惯用法的 Playwright 代码，并带有移动端特定的 UX 断言，最终在 e2e/mobile/ 下产出可用的测试项目。
主要能力
- 将工作流 Markdown 编译为 Playwright 测试代码，产出的项目在运行时不再依赖源工作流 Markdown。
- 双浏览器覆盖：Chromium 与 WebKit，均模拟 iPhone 15 Pro。
- 认证脚手架：始终生成 auth.setup.ts，支持从 .playwright/profiles 读取已保存的 profile，或回退到环境变量凭据，凭据缺失时优雅降级为空存储状态。
- 选择器发现：通过 Explore 代理分析代码库，优先使用 getByRole、getByLabel、getByPlaceholder、getByText、getByTestId，CSS 选择器作为最后手段，并关注汉堡菜单、底部导航栏、滑动手势目标、下拉刷新等移动端特有元素。
- 任务列表与进度跟踪：创建任务树（主任务、解析、检查、选择器、生成、审核、写入），支持会话恢复与审计追踪。
- 已有项目管理：检测既有 e2e/mobile/ 项目并提供覆盖、更新或取消选项。
- CI 配置：生成 GitHub Actions 工作流，在 Vercel 预览部署成功时触发运行。
- 处理已弃用工作流：跳过标记为 deprecated 的工作流并记录。
使用方式
输入文件位于 /workflows/mobile-workflows.md，输出到 e2e/mobile/。生成的项目结构包括：playwright.config.ts、package.json、tests/auth.setup.ts、tests/workflows.spec.ts、.github/workflows/mobile-e2e.yml、.gitignore。运行命令为：
cd e2e/mobile && npm ci && npx playwright test
package.json 中提供的脚本包括：test、test:ui、test:headed、test:chromium、test:webkit。
工作流文件遵循 docs/workflow-format.md 定义的格式，包含标题、元数据注释、步骤格式、可识别动词与断言类型。解析阶段提取工作流编号、名称、认证要求、优先级、预估步骤数、前置条件、步骤、后置条件等。
生成过程按阶段进行：解析工作流、检查已有项目、选择器发现（委托给代理）、生成 Playwright 项目、审核批准、写入文件。会话恢复时若检测到已有任务列表，会从最后完成的任务继续。
适用场景
适用于已有移动端工作流文档、希望自动生成端到端移动测试的项目；适用于需要同时覆盖 Chromium 与 WebKit 移动浏览器的团队；适用于使用 Vercel 部署并希望在预览环境自动运行移动 E2E 测试的场景；适用于希望以任务列表跟踪生成进度并保留审计轨迹的自动化流程。
限制
未找到 /workflows/mobile-workflows.md 时会停止并提示用户先运行 "generate mobile workflows" 或提供路径。选择器阶段无法在代码库中找到的元素，会在测试代码中生成 TODO 注释。无论工作流是否需要认证，auth.setup.ts 都会被生成。未在资料中说明平台支持范围、收费模式、性能或效果指标。生成的配置中，baseURL 默认取 process.env.BASE_URL 或 http://localhost:3000，CI 重试次数为 2，本地为 0。