AI Skill 大全

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 工程师

使用步骤

  1. [object Object]
  2. [object Object]
  3. [object Object]
  4. [object Object]

开始使用

将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。

查看 MCP 接入说明

技术信息

分类
编程
适用工具
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.

依赖与权限

  • 读取用户主动提供的内容

同类 Skill