| name | pdlc-api-mock |
| description | API Mock 数据生成 |
| argument-hint | <接口路径 | OpenAPI 文件> |
| allowed-tools | Read, Write, Edit, Glob, Grep, Bash |
| layer | 3 |
| stage | engineering |
| produces | [] |
| requires | [] |
| next_step | null |
| terminal_state | null |
API Mock 数据生成
根据 API 设计文档生成 Mock 数据和 Mock 服务配置,供前端联调使用。
工作流程
- 阅读 API 设计: 阅读
docs/02_design/api/ 下的 API 设计文档
- 生成 Mock 数据: 为每个接口生成符合数据模型的 Mock 响应
- 生成 Mock 配置: 根据技术栈生成对应的 Mock 服务文件
- 输出到指定位置: 前端应用的
mock/ 或 src/services/__mocks__/ 目录
Mock 数据要求
- 数据要贴近真实场景,不要用 "test1"、"aaa" 之类的无意义数据
- 列表接口至少生成 5-10 条数据
- 覆盖各种状态:正常数据、边界数据、空数据
- 包含分页信息
- 错误响应也要生成 Mock
输出格式
{
"code": 0,
"message": "成功",
"data": { ... }
}
要求
- Mock 数据中的中文内容要有实际含义
- 时间字段使用合理的时间范围
- ID 字段使用合理的格式(UUID/数字)
- 生成完成后告知前端同学如何启用 Mock 服务
目标接口: $ARGUMENTS
本命令的 handoff 输出:
✅ API Mock 数据 完成
📦 产出:(生成到前端应用 mock/ 目录)
👉 下一步:(本次流程结束,无后续)