apifox-mock-script-gen

npx skills add majiayu000/claude-skill-registry --skill apifox-mock-script-gen --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Apifox Mock 脚本生成器 ## 核心原则 > ⚠️ **无文档不生成！必须先获取 API 文档，才能编写 Mock 脚本。** ## 反模式警示（禁止行为） ### 反模式1：凭经验猜测数据结构 ``` ❌ 听到"营业时间"就认为是 object {monday: "5-18"} ✅ 必须先查看文档，确认是 array 还是 object ``` ### 反模式2：跳过文档获取步骤 ``` ❌ 用户描述需求后直接生成代码 ✅ 必须先调用 apifox_get_api_detail 获取文档 ``` ### 反模式3：忽略嵌套类型 ``` ❌ 只检查顶层字段 $.data.businessHours 的类型 ✅ 必须检查嵌套字段 $.data.businessHours[0].day 的类型 ``` ## 执行流程（强制顺序） ### 第一阶段：信息收集 🔴 [必须先完成] ```markdown 1. 🔴 强制：调用 mcp__apifox-api-docs-mcp__apifox_get_api_list └─ 如果失败，停止并报错："无法获取接口列表" 2. 🔴 强制：匹配目标接口并获取 apiId └─ 如果找不到，停止并报错："未找到目标接口" 3. 🔴 强制：调用 mcp__apifox-api-docs-mcp__apifox_get_api_detail └─ 如果失败，停止并报错："无法获取接口详情" 4. 🔴 强制：提取类型定义并创建映射表 └─ 遍历所有字段，记录路径和类型 ``` ### 第二阶段：需求确认（可选） 在获取文档后，向用户确认： - [ ] 是否需要分页支持？ - [ ] 是否需要 Token 验证？ - [ ] 是否需要模拟网络延迟？ - [ ] 是否需要异常场景（404、500 等）？ - [ ] 是否需要参数校验逻辑？ ### 第三阶段：脚本生成（基于文档） ```markdown 1. 参照类型映射表生成 Mock 数据 2. 根据需求选择代码模式（见 references/code-patterns.md） 3. 为每个字段添加类型注释 ``` ### 第四阶段：质量验证（逐字段检查） ```markdown ✓ 步骤1：验证 API 调用方式（使用 fox. 前缀） ✓ 步骤2：验证函数调用（handleRequest() 被调用） ✓ 步骤3：🔴 逐字段验证类型（对照类型映射表） ✓ 步骤4：验证嵌套类型（array 元素、object 字段） ✓ 步骤5：验证必填字段（有默认值） ✓ 步骤6：验证注释完整性 ``` ## 类型映射表创建流程 从 API 文档提取类型后，创建类型映射表： ```javascript // 从 API 文档提取的类型定义 var typeMapping