SuperAPI AI 工具集

api-test-bruno

测试与质量

查看项目

更新于 10-16 01:34

技能介绍

用途:把 API 测试结果落到 Bruno 结构或 Bruno 工作流中,解析多格式 API 定义并生成 Bruno 集合,用于可执行回归测试。适用于项目已在使用 Bruno,或希望输出直接适配 Bruno 的场景。

主要能力:生成脚本仅生成已知字段的 smoke 断言,必须提供非空 endpoints 与明确 expected_statuses,可选 expected_json 和来源化 max_response_ms。缺数据、未解析参数/变量或 response_schema 待实现时,生成失败工件并以非零退出,不能运行成绿色。

使用方式:先读 references/generator-contract.md,目标与凭据必须显式配置。产出前必须阅读并遵循 prompts/api-test-bruno.md 的最低覆盖清单、输出结构与质量要求。需要模板时读 output-templates/ 中匹配模板;需要示例时读 examples/;需要深资料时只读 references/ 中相关文件;格式转换或辅助校验优先用 scripts/ 已有脚本;评测回归用 evals/ 并以 skill-up 校验运行。默认输出 Markdown,用户指定其他格式时再切换。

适用场景:Bruno 集合结构、环境设置、认证处理、高优先级接口、正向场景、异常与边界场景、变量与数据策略、断言重点等。

限制:按风险与业务影响排优先级,不平均摊铺;区分已确认事实与当前假设;不编造未提供的接口、字段、环境或根因细节;鉴权与密钥一律用占位符或环境变量语义,禁止硬编码真实凭证;结果须可执行。信息不全时先给可用初版并标明假设与信息缺口。