pdlc-api-mock
API Mock 数据生成
SKILL.mdskills/pdlc-api-mock/SKILL.md
GitHubAPI Mock 数据生成
<!-- @include templates/prompts/iron-law-tool.md(已内联于下方,无需另读) -->⛔ IRON LAW · 不可违反的硬门禁(工具型命令)
本命令不是主链路上的阶段:不追加 history,不改 current_stage / next_step / last_phase_result,也不为此分配功能ID。以下规则不可协商:
- 文件必须落盘:正文要求创建的文件必须作为实际文件写入磁盘,不可仅在对话中输出(只要求在对话里输出的,照正文办)。
- 自检必须执行:产出后按本命令的自检项逐项核对,不得以"已经很好了"为由跳过。
- 防循环:修复只做一次,不递归。修不了的问题记进报告,继续往下走。
违反任一条 = 立即中止当前命令,输出违规详情,等待人工介入。
<!-- @include-end templates/prompts/iron-law-tool.md -->根据 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
<!-- @include templates/prompts/handoff.md(已内联于下方,无需另读) -->段四:交接(Handoff)
命令完成后必须输出以下格式的最终消息:
✅ <阶段名> 完成:<主要产出物路径>
📊 自检:<通过数>/<总数> 通过(若有未通过,附要点)
📦 状态快照:docs/.pdlc-state/<feature-id>.json
👉 下一步:/pdlc-<next_step>
(如果有分叉)或 /pdlc-<alt>(条件:<选择依据>)
规则:
- 主流程命令(写状态机的命令;下一跳见正文里「本命令的状态机取值」)必须显式输出"下一步",不可省略
- 工具型命令(Layer 3)可以没有
next_step,此时输出👉 下一步:(本次流程结束,无后续) - 分叉场景必须说明选择条件,例如"若需补充测试用例 →
/pdlc-tdd;若测试已齐 →/pdlc-review"<!-- @include-end templates/prompts/handoff.md -->
本命令的 handoff 输出:
✅ API Mock 数据 完成
📦 产出:(生成到前端应用 mock/ 目录)
👉 下一步:(本次流程结束,无后续)