API 类型同步
在 Supabase 仓库里用 codegen 与 verify-types 命令,让已提交的 API 类型声明跟生产 OpenAPI schema 保持一致。
功能与用途
后端改了字段、发了新版本,前端却还在用旧的类型声明,报错信息指向一堆看不懂的类型不匹配。这个 Skill 只管一件事:把仓库里三份生成的 API 类型(v1、v2、Platform)跟线上的 OpenAPI schema 对齐。它会带你走完整流程——先确认变更已经部署到生产,再对本地环境跑 codegen 生成类型,然后跑 verify-types 去抓生产 spec 做比对。它还会告诉你校验失败该怎么读:是生产没部署、还是仓库该重新生成,或者只是生产端点读不到。
适用场景
- 后端同学加了一个字段、改了一个枚举,PR 里的类型声明没人重:后端同学加了一个字段、改了一个枚举,PR 里的类型声明没人重新生成,前端拉下来 compile 就一片飘红
- 本地 codegen 生成完看着没问题,合并后 CI 的 V:本地 codegen 生成完看着没问题,合并后 CI 的 Verify production API types 飘红,你分不清到底是生产没部署还是仓库里漏提交了文件
- 生产 OpenAPI 端点临时抽风导致校验报错,同事当成类型:生产 OpenAPI 端点临时抽风导致校验报错,同事当成类型漂移开始准备回滚,你想先确认清楚到底是不是真的不一致
适用人群
- Supabase monorepo 前端/全栈工程师
- 维护 API 契约的 SDK 工程师
- 负责发版流程的 DevOps 工程师
使用步骤
- [object Object]
- [object Object]
- [object Object]
- [object Object]
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- master
- 最近更新
- 2026-09-17
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Maintain Supabase API types. Use when changing generated API type declarations, OpenAPI schemas, or investigating API type deployment drift.
依赖与权限
- 读取用户主动提供的内容