用途:这是一个 API 测试助手技能,通过 Postman CLI 运行 Postman 集合测试。当用户要求“运行测试”“运行我的集合”“验证改动”“检查测试是否通过”“运行 postman 测试”或“执行集合”,或在可能影响 API 行为的代码改动之后,或想验证 API 端点是否正常时触发。
主要能力:定位 postman/collections/ 下的集合文件夹,读取 .postman/resources.yaml 中 cloudResources.collections 的云端 ID 映射;按集合 ID 运行测试;支持环境文件、--bail、--timeout-request、--env-var、-i 等选项;解析 CLI 输出并结构化报告断言通过/失败数、请求数、耗时与失败详情;失败时结合错误信息与相关源码分析根因、提出修复建议、经用户同意后应用并重跑,直至通过或用户停止。
使用方式:集合采用 v3 文件夹格式,每个集合是一个目录,含 .resources/definition.yaml 与各 .request.yaml 文件。先 ls postman/collections/ 列出集合,cat .postman/resources.yaml 获取 ID。运行命令为 postman collection run <collection-id>;带环境为 postman collection run <collection-id> -e ./postman/environments/<env-file>.json;其他选项如 --bail、--timeout-request 10000、--env-var "base_url=http://localhost:3000"、-i <folder-or-request-uid>。执行前始终展示确切命令。检查 postman/environments/ 是否存在环境文件,仅在存在时才加 -e。
适用场景:运行集合测试、执行 API 测试套件、代码改动后验证接口、排查测试失败并修复。
限制与错误处理:CLI 未安装时提示 npm install -g postman-cli;未认证时提示 postman login;集合未找到、服务器未运行、请求超时均有对应提示。无集合时提示将仓库连接到 Postman 工作区同步;本地有集合但无云端 ID 时提示可能需要同步。不要暴露测试输出中的敏感数据(令牌、密码)。