← ClaudeAtlas

postmanlisted

Postman 云端 Collection 与 Request 维护及请求执行:通过 Postman API 精细增删改 Collection、Folder、Request、Response、共享环境变量,并使用 Postman CLI 运行临时请求、Collection、指定 Request 或批量同步。当用户明确要操作 Postman 资源或通过 Postman 执行 API 时使用;普通 HTTP/curl 问题不要触发。
soapgu/Postman-Skill · ★ 0 · Testing & QA · score 70
Install: claude install-skill soapgu/Postman-Skill
# Postman 使用 Postman CLI 与 Postman API 完成云端资产维护和请求执行。开始前运行 `postman --version`,要求 `>= 1.51.0`。云端资源发现与 CRUD 直接使用 API 助手,不使用 Postman CLI 判断 API 登录状态,也不为 API 操作增加额外的 CLI 认证检查。 ## 路由 - Workspace 查询,以及 Collection、Folder、Request、Example Response、Environment 的云端查询与增删改查:使用 `scripts/postman-api.mjs`。先阅读 [`references/operations.md`](references/operations.md)。 - Authorization、Variables、Scripts、Params、Headers、Body、Settings:先读取最新云端对象,再按 [`references/collection-format.md`](references/collection-format.md) 构造最小更新。 - 临时 HTTP 请求:使用 `postman request`。 - 执行云端 Collection 或其中一个 Request:使用 `postman collection run`。 - 从本地代码生成或批量同步:使用 `postman workspace pull/lint/prepare/push`。 - Workspace 只用于查询、解析名称和确认归属;不要创建、修改或删除 Workspace。 ## 认证 API 助手读取当前用户的 `~/.postman/postmanrc`,选择 US Profile,并仅在内存中注入 `X-API-Key`。API 助手请求成功时直接继续任务,不再运行其他认证探测命令。 - 不向用户索取、显示或记录 API Key。 - 不把 Key 放进命令参数、项目文件、Collection、报告或错误信息。 - 仅当 API 助手明确报告凭据文件缺失、Profile 不含 API Key,或 Postman API 返回 401 时,才要求用户自行运行 `postman login`;不要索要 Key。 - Local Value 与 Postman Vault Secret 由用户人工维护,不自动操作。 ## 云端修改流程 1. 用户明确指定 Workspace 时按名称或 ID 解析。未指定时调用 `GET /workspaces`:仅返回一个 Workspace 就直接使用;返回多个但仅有一个 `visibility: "personal"` 时自动使用该个人 Workspace;否则展示候选名称、ID、visibility,让用户选择,不猜测。 2. 修改前读取目标最新状态,保留服务端 ID;细粒度 endpoint 能完成时不要全量 PUT Collection。 3. 创建、修改等已由用户明确要求的操作可以执行;删除、全量覆盖或 `force-sync` 必须在实际调用前再次明确影响范围并取得确认。 4. 更新只提交需要改变的字段。接口成功后重新读取目标,验证名称、ID 和关键字段。 5. 返回资源 ID、变更摘要与验证结果,不输出凭据或无关响应体。 禁止自动运行 `postman workspace push --push-strategy force-sync`。普通 `wo