API 模拟与沙箱助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/api-mock-helper。
技能介绍
前端与后端不同步时怎么办
后端接口还没就绪,或只能在联调环境访问时,前端和自动化测试往往被卡住。契约变了也没有稳定的「假后端」可跑。这个技能把 API 模拟 当成可交付的工程输出:按你的场景选工具,而不是泛泛讲 Mock 概念。
技能会怎么帮你落地
技能会先对照场景选策略,例如:
- 前端对着未完成的 API:倾向 WireMock、Prism 或 MSW
- 进程内单元测试:内存里的模拟函数
- 契约测试:Pact(消费者驱动)
- Postman 流程:Postman Mock Server
- 本地开发:基于 OpenAPI 的 Prism CLI
- 录真实流量再回放:VCR(Python/Ruby)、nock 录制
在具体实现上,会覆盖 WireMock 桩(含有状态场景)、MSW(浏览器与 Node.js)、测试数据生成,以及 Prism CLI 从 OpenAPI 规范启动模拟服务。每个端点还会要求带上错误场景桩,避免只测 happy path。
模拟交付完成后,技能会问你是否需要为这些 API 设计速率限制;若你确认且已安装 api-ratelimiting-helper,会按该技能的说明继续;未安装则提示安装后重跑,选「否」则在此结束。
适用边界
它聚焦「怎么搭模拟层、写什么桩、用什么数据」,不替代你编写真实的 OpenAPI/业务契约。Pact、VCR 等需要对应运行时与项目结构;有状态 WireMock 要自行设计状态机,技能给的是模式与清单,不是替你猜业务规则。
使用场景
- OpenAPI 已定稿但后端未上线,前端需在本地用 Prism 或 MSW 拦截请求完成页面联调
- 单元测试不想打真实 HTTP,要在进程内用内存桩覆盖成功与失败分支
- 消费者与服务提供方分团队开发,要用 Pact 在 CI 里校验请求/响应契约
- 联调环境不稳定,先用 nock 或 VCR 录下真实响应,再在测试里固定回放
适合人员
- 负责 B 端控制台的前端,接口排期滞后,需要 WireMock/MSW 桩先跑通表单与列表
- 写微服务集成测试的后端,希望每个 REST 端点都有 4xx/5xx 错误桩而不只测 200
- 维护 OpenAPI 仓库的平台同学,想用 Prism CLI 给全组提供一致的本地 mock 服务
- 用 Postman 做回归的 QA,需要 Mock Server 与测试数据生成器对齐同一套接口定义