SuperAPI AI 工具集

generate-bat-tests

测试与质量

查看项目

更新于 10-15 17:32

技能介绍

用途:为 Mule 应用生成可运行的 BAT(Blackbox API Testing,MuleSoft API 功能监控框架)BDD 测试套件,包含 DataWeave .dwl 文件与 bat.yaml 清单,按质量维度组织,并通过针对实时端点运行来验证。适用于生成 BAT 测试、编写黑盒 API/BDD 测试、创建 Anypoint API 功能监控测试、扩展或刷新已有 BAT 套件。不适用于 MUnit(构建期、进程内、XML、XSD 校验)。

主要能力:分两阶段工作流。阶段一为测试设计(步骤1-6):校验工具链(jq、$HOME/.bat/bat 的 BAT CLI、Java 17+),用 extract_endpoints.sh 从 Mule 源码提取 http:listener 路径与 <raise-error> 类型,阅读 OpenAPI/RAML 契约与 Mule 流程 XML,读取已有 BAT 基线,起草按质量维度标记的测试清单,派生端点允许列表,展示清单摘要并等待用户明确批准。阶段二为生成与运行(步骤7-11):确认运行时 URL 与令牌,用 scaffold_suite.sh 搭建套件骨架,编写 .dwl 与 bat.yaml,运行静态校验器,执行 ./run-bat.sh 针对实时端点,最后写 REPORT.md 并声明完成。

使用方式:通过 Bash 工具调用技能自带脚本,使用绝对路径 <skill-dir>。关键命令包括:bash <skill-dir>/scripts/validate_prerequisites.sh;bash <skill-dir>/scripts/extract_endpoints.sh <app-dir>;bash <skill-dir>/scripts/scaffold_suite.sh <suite-dir> --url "<config.url>" --token "<bearer>";bash <skill-dir>/scripts/validate_bat_suite.sh <suite-dir> --allowlist tmp/bat-gen/endpoint-allowlist.txt;cd <suite-dir> && ./run-bat.sh。测试使用 $(config.url) 与 config.token 插值,禁止硬编码 URL 或令牌。

限制:仅黑盒测试,不导入 Mule 流程或断言内部状态;端点只能来自源码,不得虚构;阶段二必须在步骤6批准后开始;运行是唯一正确性门槛,未运行的套件不得声明完成;发现疑似应用缺陷不得修改应用,应标记为差异供人工审查。具体收费、价格、平台支持等信息暂未提供。