SuperAPI AI 工具集

jp-validate

测试与质量

查看项目

更新于 10-15 23:43

技能介绍

用途:在 jp-executor 完成 Juspay 支付集成后进行测试与验证,依据 {doc_workspace} 中的规划产物(jp-prd 的 PRD、jp-architecture 的设计与 task-checklist.md)以及代码库实际内容开展工作。

主要能力:检测仓库已有测试框架与约定(目录结构、命名、fixtures)并以其编写真实的持久化测试;仅当不存在测试运行器时回退到内联 curl/bash。按支付风险划分优先级,请求/响应结构在写测试时通过 docs-mcp 重新拉取 Juspay 官方文档确认,而非依赖记忆。每个持久化测试要求确定性、隔离、显式、聚焦,禁止硬等待/睡眠、测试间顺序依赖、不受控随机数据。凭据仅通过 .env/密钥库导出为环境变量传入,绝不写入测试文件、报告或日志。测试范围取架构范围内、实际已构建、环境支持三者的交集。支持前后端分离仓库:仅验证本仓库一侧并做契约符合性检查,跨端端到端交易记为文档化的手动项或缺口。

使用方式与流程:读取 prd.md、architecture.md、task-checklist.md、integration-summary.md(如有)、handoff-<this_side>.md(如有),将测试代码写入用户代码库,更新 task-checklist.md 中的测试任务状态,并把 test-report.md 写回 {doc_workspace};不修改 integration-summary.md 或 handoff-*.md。步骤链为 step-01-init.md(入口门槛、加载产物、检测测试栈、重扫已构建内容)、step-02-test-design.md(基于风险的测试设计、P0–P3 分级、构建可追溯性矩阵、环境预检、计划检查点)、step-03-backend-tests.md(仅后端被构建时:下单/会话创建、状态与对账、webhook 签名与幂等、退款/打款、约束边界、错误码路径)、step-04-frontend-sdk-tests.md(仅 Web/SDK/原生界面被构建时:Web 交易驱动使用测试卡/VPA 与返回 URL 对账检查,原生为手动指南)、step-05-report.md(可追溯性矩阵、PASS/CONCERNS/FAIL 质量门、支付 NFR 检查、集成阶段确认、写 test-report.md)。步骤 3、4 带适用性门槛,可自行跳过。技能无自身配置文件,语言与名称解析不做处理。

限制:运行针对生产环境强制执行,不询问使用哪个环境,仅当用户明确主动要求时才用非生产环境;测试网关返回的 dummy/test 网关可用于集成测试。执行真实测试,但在高风险/外部动作前需检查点确认(启动开发服务器、运行真实交易、任何涉及资金或触及生产的操作)。juspay-mcp 有鉴权且可选,复用上游已记录的模式,不重复询问,其每个数据都有手动回退方案,流程不会阻塞。集成阶段跟踪通过 juspay_track_integration_stage 触发,即发即忘、不阻塞。