API Mock 锻造工坊
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_8ee65e73/api-mock-forge。
技能介绍
解决什么问题
写后端接口时常会遇到两类情况:一是前端已经排期,后端逻辑仍在演进;二是依赖的第三方接口尚不稳定,但联调剧本已经写好了。直接把真实服务接进本地开发环境,要么被鉴权卡住,要么血流成河。更糟糕的是,接口字段几乎每次迭代都会动一点,导致自动化测试和 mock 数据之间不断漂移。
api-mock-forge 把注意力收窄到 API 开发中的模拟层:把一个接口的返回形态和少量关键字段样例固化进技能描述,后续由 Agent 按需产出 mock response。目标是让开发在真实依赖没就绪时,也不用牺牲测试覆盖率。
核心能力与流程
该技能属于 dev-programming 分类,本体是一个 SKILL.md 加资源文件。实际执行的关键是 Agent 严格按照技能说明解析输入并产出输出。
- 抽取请求结构:从你提供的 OpenAPI/路由信息中抽取 URL、Method、必需 query 与 body 字段。
- 生成样本数据:按字段名与示例,生成符合常见格式的假值,例如
id→ 数值、email→ 带@的字符串、createdAt→ ISO 时间戳。 - 维护响应形态:继续追加字段或统一替换 payload 时,沿用已有的 envelope 与状态码结构,避免凭空长出新的
data_result包。
适用边界与注意点
- 当前资料只包含技能说明,未提供可运行的转换器。Agent 必须按技能描述执行;如果 SKILL.md 与当前 Anthropic API 约定不兼容,需要你在本地补一份预设模板。
- 生成的 mock 数据不等于业务校验逻辑。需要校验枚举值和长度约束时,仍要在测试代码里单独覆盖。
- 适合接口契约稳定、只缺返回数据的场景。如果字段含义、校验逻辑、状态流转都还没定,建议先用一份 OpenAPI spec 校准后再用技能。
- 当前无 Stars、下载量或热度指标可佐证质量,建议在自己的仓库中小规模测试,观察生成结果是否贴合真实字段名。
使用场景
- 后端接口仍在演进,前端需要按 OpenAPI 契约生成本地 Mock 响应以并行开发页面组件和交互逻辑
- 编写自动化测试时缺少稳定依赖,需基于路由信息生成固定结构的响应payload以覆盖字段校验分支
- 第三方支付接口在测试环境频繁变动,团队希望通过技能固化现有字段样本维持本地开发和联调脚本运行
- 接口迭代仅追加新字段,要求生成的 mock 响应在扩展时保持原有 envelope 结构和状态码约定
适合人员
- 前端工程师:在后端接口未冻结时仍需完成页面联调和字段映射开发
- 测试工程师:构建依赖稳定响应结构的自动化测试但缺少可用的真实服务
- 后端开发者:需要在接口迭代中快速生成样例数据供审查和下游模块集成
- 开发团队:协调本地开发环境与不稳定的第三方服务之间的开发节奏