SuperAPI AI 工具集

finalrun-generate-test

测试与质量

查看项目

更新于 10-15 21:33

技能介绍

用途:作为 QA 自动化工程师技能,规划新的测试活动、查找按功能分组的现有测试资产、向用户提出方案并在批准后保存为严格 FinalRun YAML。

主要能力:仅针对面向用户的功能编写测试(交互、手势、导航、表单校验、搜索筛选、移动端行为),不测 API、后端逻辑或第三方认证内部。禁止硬编码凭据,使用 ${variables.KEY} 与 ${secrets.KEY},在 .finalrun/env/<env>.yaml 中声明。应用标识写入 .finalrun/config.yaml,用 app.packageName(Android)与 app.bundleId(iOS),并优先从代码库推断。

使用方式:前置条件为 finalrun CLI 已安装并在 PATH 中。流程分六步:分析请求与源码并推断应用标识;分析状态依赖与空态/错误态边界用例;检查 .finalrun/tests/ 与 .finalrun/suites/ 按功能分组,决定更新或新建;向用户提出计划(含目标路径、Setup 与幂等清理策略、变量与密钥清单、边界用例清单),未获明确批准前不写最终 YAML;批准后生成或更新测试与套件;最后运行 finalrun check(可用 --suite、--env)作为校验标准。

关键约束:每个 Setup 与清理流程必须幂等,需先清理旧状态并加 Verify 步骤确认;步骤只能使用允许的动作词表(tap、long_press、input_text、swipe、navigate_back、navigate_home、rotate、hide_keyboard、deep_link、set_location、wait、Verify);中间状态用内联 Verify,expected_state 只留最终界面;不要校验 toast 等瞬时 UI;位置描述是严格断言,元素不在描述位置即失败。不要读写 .env.* 文件,不要求其存在。缺失信息(如具体环境名、应用标识)需向用户确认,资料未提供默认值。