HTTP API 测试运行器

要解决什么问题

接口联调时，我们常在浏览器 Network 里点几次、或随手 curl 一条，看到 200 就以为没问题。过几天环境变了、Cookie 过期、或断言只靠肉眼扫 JSON，同样的检查很难复现，失败时也只剩一大段原始响应。

这个技能把一次性的 HTTP 检查收成两样可重复产物：一份 .http 用例文件，以及能批量执行并打印 PASS/FAIL/SKIP 报告的格式化脚本，而不是把响应体原样倒出来。

技能如何工作

你提供 Base URL、端点、方法、鉴权方式（Cookie、Bearer、自定义头或无鉴权）、请求体/查询参数，以及各场景的期望结果（状态码、JSON 路径、文本标记、errno、列表成员等）。技能会按项目习惯在测试或文档附近生成：

• .http 文件：用 @host、@token 等变量；每个用例一条请求；用 ### 标题和 expect.* 注释写断言（如 expect.status、expect.json_path + expect.equals、expect.list_contains）。
• 格式化脚本：解析 .http、从环境变量读密钥、用 curl 发请求（带超时），尽量解析 JSON，按用例输出可读报告；任一非 SKIP 用例失败则非零退出。默认优先 bash + curl，JSON 解析倾向内嵌 python3，避免强依赖 jq。

密钥处理：默认可提交产物里不写真实 Cookie/Token，占位符 + 脚本读 COOKIE、AUTH_TOKEN 等；缺密钥时鉴权用例 SKIP 并说明，而不是误报解析失败。仅在你明确要求本地便利时，才在本地脚本里嵌入，并带发布前检查提示。

适用边界与注意点

• 适合：REST/HTTP 多场景回归、从浏览器/cURL 复现请求、需要汇总「哪些 case 过了」的联调。
• 断言以 .http 里显式 expect.* 为准；若 API 用 code/error 而非 errno，生成逻辑会按约定适配字段名。
• 鉴权失败或登录页返回时，应对照完整 Cookie/Authorization 头、host/路径与环境是否一致，以及 CSRF 等业务头是否缺失。
• 列表校验通过但条目看起来不对时，脚本应展示实际匹配项；结构稳定时优先 JSON 路径断言，少靠全文模糊搜索。