Agent Skills
返回列表
💻

Postman 集合生成器

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/postman-collection-generator。

技能介绍

问题在哪

手上有 cURL、口头约定的 REST 端点,或混在一起的片段描述时,手工在 Postman 里逐条建请求、填 Header、拆 Query、配变量,既慢又容易漏字段。团队更需要的是可直接 Import 的 Collection v2.1,且主机和令牌不要写死在 JSON 里。

技能如何工作

技能把输入当成「端点清单」来解析,每个端点尽量抽出:名称、HTTP 方法、URL(主机用 {{base_url}})、请求头、认证方式、Body(JSON / form-data)、查询参数。信息不全时会按常见 REST 约定补全,并在输出末尾列出假设。

随后按固定 schema 组装集合:请求项带 method、url、header,有 Body 时用 raw + JSON;相关端点可放进文件夹(仅有 name 与嵌套 item 的项)。同时生成配套 Postman 环境,把 base_url 以及文中出现的 token、API Key、ID 等收成变量(如 {{token}})。

对 cURL 有明确映射,例如 -X → 方法、-H → 头、-d → raw JSON、--data-urlencode → form-data、-u / --bearer → 认证、URL 上的 ?key=val → query。

交付物固定为两块:collection.json 与 environment.json,并附 Postman 导入说明(File → Import)。输出前会做质量检查:schema URL、变量化 URL/令牌、JSON 合法性、每项至少含 method/url/header。

边界与注意

输入越模糊,推断越多——务必阅读「假设」列表。集合生成完成后,技能会询问是否继续生成 OpenAPI;若未安装对应文档技能,只能提示安装后再跑,不会凭空编造 OpenAPI 流程。

使用场景

  • 把文档或聊天记录里多条 cURL 一次性整理成可导入 Postman 的 Collection v2.1 与环境变量
  • 只有自然语言描述的端点(方法、路径、Body),需要补全 REST 约定并输出标准集合 JSON
  • 部分接口是 cURL、部分是文字说明,需要合并成同一集合并按资源或功能分文件夹
  • 联调前要把 `base_url`、Bearer token 等从描述里抽成环境文件,避免密钥写进 collection

适合人员

  • 负责对接第三方 HTTP API、手头只有官方 cURL 示例的后端或集成工程师
  • 收到产品或后端口头/文字接口说明、需要在 Postman 里快速建请求做冒烟测试的 QA
  • 要把联调命令沉淀给同事、又不想逐条手建 Header 与 Query 的全栈或平台开发
  • 在 API 设计阶段先交付可导入 Postman 的集合与环境模板、再考虑是否补 OpenAPI 的接口设计人员