SuperAPI AI 工具集

multi-agent-e2e-validation

测试与质量

查看项目

更新于 10-16 00:20

技能介绍

用途:该技能提供一套处方式工作流,用于为数据库重构类变更(例如从基于文件的 v3.x 迁移到 QuestDB v4.x)生成并运行多个并行验证智能体,以在发布前发现关键缺陷。适用触发场景包括 E2E 验证、模式迁移测试、数据库重构验证、批量数据摄取管道测试以及面向数据库系统的预发布验证。

主要能力:采用三层验证模型,第一层为环境搭建(容器编排、数据库部署与模式应用、ILP/PostgreSQL/HTTP 端口连通性验证、配置文件创建);第二层为数据流验证(批量摄取、性能对标 SLO、多月数据摄取、去重与重摄取、类型转换如 FLOAT→LONG);第三层为查询接口验证(get_latest、get_range、execute_sql 等高层方法,边界情况如 limit=1、跨月边界,错误处理,以及 gap 检测 SQL 兼容性)。智能体编排上,环境智能体必须顺序先行通过,数据流与查询接口智能体之间无依赖,可并行执行;待办列表随发现的缺陷动态裁剪与扩展,并将结果持续写入 VALIDATION_FINDINGS.md。

必要用法:先依据 ADR 文档制定含 3 至 7 个智能体的验证计划;执行环境智能体并完成端口(9009 ILP、8812 PG、9000 HTTP)与模式检查;随后在两个终端中分别运行 uv run python test_bulk_loader.py 与 uv run python test_query_interface.py;测试脚本需包含 5 个以上带明确通过/失败判据的测试函数并输出结构化结果;缺陷按 Critical/Medium/Low 分级记录位置、影响、根因、修复与验证;最后严格套用 Go/No-Go 准则(存在未修复 Critical 即阻塞,所有 Critical 修复且 Medium 可接受或已修复即发布,超过 3 个未修复 Medium 或存在高严重度问题则推迟)。

适用场景与限制:适用于数据库重构、模式迁移、批量摄取与多验证层的系统迁移。资料未提供具体平台、费用或额外依赖信息;测试脚本为项目专属,需存放在 tmp/e2e-validation/ 下,并行智能体须使用隔离目录以避免资源冲突;文档提示需在每次修复后重新验证并更新状态。