Agent Skills
返回列表
💻

接口调试 命令行速测

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a10ab3ad/cli-command-tester。

技能介绍

要解决什么问题

联调时你往往不想为了打一个 GET 或 POST 去开 Postman,也不想在脚本里临时写 curl 再调格式。本技能把 HTTP 命令行速测 收敛成固定流程:在对话里给出 URL、方法、头和 body,由技能按约定执行并返回可读结果,适合后端验逻辑、前端看返回、测试造边界请求。

核心能力与执行方式

技能围绕「构造请求 → 发 HTTPS/HTTP → 展示响应」展开,能力边界在文档里写得很清楚:

  • 方法与 URL:支持 GET / POST / PUT / DELETE / PATCH / HEAD / OPTIONS
  • 请求头:例如 -H "Authorization: Bearer token"、自定义 Content-Type
  • 请求体:JSON、表单、原始文本,如 -d '{"name":"test"}'
  • 查询参数:-p "page=1&size=20" 等,查询串会做编码
  • 响应处理:JSON 自动缩进与高亮,过长内容可截断;可用 -o response.json 落盘
  • 其它:超时 -t、跟随重定向 -L 等

典型用法形态类似:cli POST https://api.example.com/users 或带头、体的组合。执行上技能会读取参数或交互输入,跑完核心逻辑后输出结构化结果;失败时会给非零退出码、明确错误信息与排查建议(缺依赖、网络异常等),并带上 error context,不悄悄吞错。

运行环境要求 Python 3.9+,文档称开箱即用、无额外依赖;需要真实访问接口时网络要通。

边界与注意点

下列情况不要指望本技能包办:

  • 仅 HTTP/HTTPS,不支持 WebSocket
  • 不支持文件上传,请求体限于文本
  • 无 Cookie 持久化,每次调用是独立会话
  • 无内置代理 / 双向 TLS,代理需在系统层配置,证书走常规 HTTPS 校验

另外文档中的用户协议与免责声明表明:内容仅供学习参考,专业决策需咨询持证人士;使用结果由使用者自行承担。把技能当终端侧的快速探针,而不是替代完整测试平台或安全审计工具,预期会更准确。

使用场景

  • 后端新增路由后,在终端用 `POST` 与 JSON body 快速核对状态码和返回字段是否与设计一致。
  • 前端联调时带上 `Authorization` 头执行 `GET`,检查分页查询参数编码后的列表 JSON 结构。
  • 测试需要发送含边界字段的 `PUT` 或 `DELETE` 请求,并阅读自动格式化后的错误响应体。
  • 部署后从 shell 对 health 地址执行带超时与 `-L` 的 `GET`,确认重定向与可达性。

适合人员

  • 维护 REST 接口的后端工程师,需要在对话里复现带自定义请求头的线上失败请求。
  • 正在对接后端契约的前端工程师,要快速查看某 HTTPS 地址在特定 query 下的 JSON 返回。
  • 负责接口用例的测试工程师,需要构造多种 HTTP 方法与文本 body 观察非 2xx 时的响应格式。
  • 值班运维或 SRE,需在无图形界面的环境做健康检查并把响应用 `-o` 保存为文件备查。