用途:作为 QA 自动化技能,为仓库生成 FinalRun 测试(.finalrun/tests/<feature-name>/*.yaml)与套件(.finalrun/suites/<feature-name>.yaml)YAML 规范,只测试面向用户的功能,不测试 API、后端或第三方认证内部逻辑。
主要能力:从代码库推断应用身份(应用名、Android packageName、iOS bundleId)并写入 .finalrun/config.yaml;按环境在 .finalrun/env/<env>.yaml 声明变量与密钥;规划测试活动时先扫描既有测试目录,按功能子文件夹避免重复,决定新建或更新;向用户提交计划并等待批准后再写文件。
使用方式:先用 finalrun CLI(需在 PATH 上);测试中以 ${variables.KEY} 和 ${secrets.KEY} 引用,密钥只用 secrets.logical_key: "${SHELL_ENV_VAR}" 占位,真实值由 shell/CI 提供,禁止硬编码口令与账号值。测试文件遵循 name、description、setup、steps、assertions 结构,缩进两空格;套件以 tests 列表引用测试路径。Setup 与 Cleanup 必须幂等:按已有状态先清理或补建数据。凭据、应用标识或功能归属不明确时须询问用户。
限制:所有测试与配置改动需用户明确批准;应用标识应优先从仓库推断而非手填;不读写 .env.* 文件,不将密钥明文写入文件;绑定正确性以 finalrun check 的输出为准,而非仅靠 grep;若 CLI 不在 PATH 需先解决安装或使用绝对路径。