API 模拟 Mock 专家

要解决什么问题

前端或集成测试往往在后端、合作方接口尚未就绪时就要联调；若直接打真实环境，既慢又容易污染数据。更常见的情况是：你只有 OpenAPI/契约文档，却需要在演示或 CI 里验证「请求路径、鉴权、错误码、延迟」是否被客户端正确处理。本技能面向这类场景：在不依赖生产系统的前提下，搭一套行为接近真实 API 的 Mock 服务，支撑并行开发与契约校验。

技能如何工作

Agent 会按你提供的 $ARGUMENTS（契约、端点、场景需求）先对齐模拟边界，再动手设计实现，而不是随机返回 JSON。

核心步骤通常包括：

• 契约与行为：明确路由、鉴权流程、错误形态（状态码与 body）、以及是否需要模拟网络延迟。
• 路由与场景：在生成响应前定义 Mock 路由、业务场景与状态迁移（例如订单从「待支付」到「已取消」）。
• 夹具策略：默认提供确定性 fixture，便于测试可重复；需要时再打开可控的随机性开关。
• 可运维性：说明如何启动 Mock 服务器、如何在多场景之间切换，避免「只有代码、没人知道怎么跑」。

更细的代码示例、检查清单与模板在 resources/implementation-playbook.md 中展开。

适用边界与注意点

• 适合：前端/集成 Mock、第三方 API 替身、演示环境、后端完成前的契约验证。
• 不适合：生产或实时联调验证、安全/渗透测试；若完全没有 API 契约或预期行为，应先补文档再模拟。
• 安全：不要在 Mock 中复用生产密钥或真实客户数据；Mock 端点应清晰标注，避免被误当作正式服务调用。