pcode-xyz·pcode-xyz/simple-skills/skills/specs-api-mock/SKILL.md

specs-api-mock

Skill4 starsChanged 45 days agoNo licenceView on GitHub

接口 Mock 层生成 + demo 接线（demo 真实数据 → 契约 1:1 mock）：契约子 agent 读项目全部接口定义（gRPC proto / HTTP yaml，运行时自行发现）生成 api-mock.js（契约字段命名、流式接口订阅推送、状态化内存 store + localStorage/window.name 镜像），数据从 demo 实际数据按「demo 字段 → 契约字段」映射播种；并行页面子 agent 只读盘点每页数据访问 → 契约 RPC/字段（covered / 未接线 / gap / pure_client）写 map 存档；接线子 agent 单写把 demo 共享数据层改为「异步预载缓存 + 同步渲染」、复制页面换脚本全走 api-mock.js；独立校验子 agent 逐调用点核对 app-mock.js 的 api.* 与接口定义严格一致，不一致循环修正到一致（上限 3 轮）；汇总子 agent 聚合写 docs/specs/review/mock-compare.md 决策单；随后自动生成 demo-review 接口看板（三列：原版 demo 参考 / demo-mock 业务页 / 实时 RPC 流量；设备尺寸预览；点击接口联动高亮中列区域 + 对照 gRPC proto 做格式校验；右列接口可打勾标记「符合预期」+ 按 proto 文件聚合的「通过看板」，模板化、任何项目复用）。产出 docs/product/demo-mock/（file:// 直开、无服务器、无网络）。当用户要做接口 mock、demo 接契约、mock 接口层生成、页面走 mock 接口、接口联调前预演时使用。